Partilhar via

WebBrowserNavigatingEventArgs Classe

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origem:
WebBrowserNavigatingEventArgs.cs
Origem:
WebBrowserNavigatingEventArgs.cs
Origem:
WebBrowserNavigatingEventArgs.cs
Origem:
WebBrowserNavigatingEventArgs.cs
Origem:
WebBrowserNavigatingEventArgs.cs

Fornece dados para o evento Navigating.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Herança
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Exemplos

O exemplo de código a seguir demonstra como usar um manipulador para o WebBrowser.Navigating evento para cancelar a navegação quando um formulário de página da Web não foi preenchido. A WebBrowser.Document propriedade é usada para determinar se o campo de entrada do formulário contém um valor. Este exemplo requer que seu formulário contenha um WebBrowser controle chamado webBrowser1.

private void Form1_Load(object sender, EventArgs e)
{
    webBrowser1.DocumentText =
        "<html><body>Please enter your name:<br/>" +
        "<input type='text' name='userName'/><br/>" +
        "<a href='http://www.microsoft.com'>continue</a>" +
        "</body></html>";
    webBrowser1.Navigating += 
        new WebBrowserNavigatingEventHandler(webBrowser1_Navigating);
}

private void webBrowser1_Navigating(object sender, 
    WebBrowserNavigatingEventArgs e)
{
    System.Windows.Forms.HtmlDocument document =
        this.webBrowser1.Document;

    if (document != null && document.All["userName"] != null && 
        String.IsNullOrEmpty(
        document.All["userName"].GetAttribute("value")))
    {
        e.Cancel = true;
        System.Windows.Forms.MessageBox.Show(
            "You must enter your name before you can navigate to " +
            e.Url.ToString());
    }
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
    Handles Me.Load

    webBrowser1.DocumentText = _
        "<html><body>Please enter your name:<br/>" & _
        "<input type='text' name='userName'/><br/>" & _
        "<a href='http://www.microsoft.com'>continue</a>" & _
        "</body></html>"

End Sub

Private Sub webBrowser1_Navigating( _
    ByVal sender As Object, ByVal e As WebBrowserNavigatingEventArgs) _
    Handles webBrowser1.Navigating

    Dim document As System.Windows.Forms.HtmlDocument = _
        webBrowser1.Document
    If document IsNot Nothing And _
        document.All("userName") IsNot Nothing And _
        String.IsNullOrEmpty( _
        document.All("userName").GetAttribute("value")) Then

        e.Cancel = True
        MsgBox("You must enter your name before you can navigate to " & _
            e.Url.ToString())
    End If

End Sub

Comentários

O WebBrowser.Navigating evento ocorre antes que o WebBrowser controle navegue até um novo documento. Você pode manipular esse evento para cancelar a navegação antes de começar se determinadas condições não tiverem sido atendidas, por exemplo, quando o usuário não tiver preenchido completamente um formulário. Para fazer isso, defina a Cancel propriedade do WebBrowserNavigatingEventArgs objeto passado para o manipulador de eventos como true. Você também pode usar esse objeto para recuperar o local do novo documento por meio da Url propriedade. Se o novo documento for exibido em um quadro de página da Web, você poderá recuperar o nome do quadro por meio da TargetFrameName propriedade.

Construtores

Nome Description
WebBrowserNavigatingEventArgs(Uri, String)

Inicializa uma nova instância da classe WebBrowserNavigatingEventArgs.

Propriedades

Nome Description
Cancel

Obtém ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
TargetFrameName

Obtém o nome do quadro da página da Web no qual o novo documento será carregado.
Url

Obtém o local do documento para o qual o WebBrowser controle está navegando.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também