WebBrowserNavigatingEventArgs Classe

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Fornece dados para o Navigating evento.

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 seguinte demonstra como usar um handler para que o WebBrowser.Navigating evento cancele a navegação quando um formulário de página 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 exige que a sua forma contenha um WebBrowser controlo 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

Observações

O WebBrowser.Navigating evento ocorre antes do controlo WebBrowser navegar para um novo documento. Pode gerir este evento para cancelar a navegação antes de começar se certas condições não forem cumpridas, por exemplo, quando o utilizador não preencheu completamente um formulário. Para isso, defina a Cancel propriedade do WebBrowserNavigatingEventArgs objeto passado ao gestor de eventos para true. Também pode usar este objeto para recuperar a localização do novo documento através da Url propriedade. Se o novo documento for apresentado numa moldura de página Web, pode obter o nome da moldura através da TargetFrameName propriedade.

Construtores

Name Description
WebBrowserNavigatingEventArgs(Uri, String)

Inicializa uma nova instância da WebBrowserNavigatingEventArgs classe.

Propriedades

Name Description
Cancel

Recebe ou define um valor que indica se o evento deve ser cancelado.

(Herdado de CancelEventArgs)
TargetFrameName

Obtém o nome da moldura da página Web onde o novo documento será carregado.
Url

Obtém a localização do documento para onde o WebBrowser controlo está a navegar.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também