WebBrowserNavigatingEventArgs Classe

Definição

Fornece dados para o evento de 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
WebBrowserNavigatingEventArgs

Exemplos

O exemplo de código a seguir demonstra como usar um manipulador para o WebBrowser.Navigating evento cancelar a navegação quando um formulário de página da Web não tiver sido preenchido. A WebBrowser.Document propriedade é usada para determinar se o campo de entrada de formulário contém um valor. Este exemplo exige que o 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

WebBrowserNavigatingEventArgs(Uri, String)

Inicializa uma nova instância da classe WebBrowserNavigatingEventArgs.

Propriedades

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 de página da Web no qual o novo documento será carregado.

Url

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

Métodos

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 Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também