WebBrowserNavigatingEventArgs Clase

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Proporciona datos para el 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
Herencia
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un controlador para el evento para cancelar la WebBrowser.Navigating navegación cuando no se ha rellenado un formulario de página web. La WebBrowser.Document propiedad se usa para determinar si el campo de entrada del formulario contiene un valor. En este ejemplo se requiere que el formulario contenga un WebBrowser control denominado 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

Comentarios

El WebBrowser.Navigating evento se produce antes de que el WebBrowser control navegue a un nuevo documento. Puede controlar este evento para cancelar la navegación antes de que comience si no se han cumplido ciertas condiciones, por ejemplo, cuando el usuario no ha rellenado completamente un formulario. Para ello, establezca la Cancel propiedad del WebBrowserNavigatingEventArgs objeto pasado al controlador de eventos en true. También puede usar este objeto para recuperar la ubicación del nuevo documento a través de la Url propiedad . Si el nuevo documento se mostrará en un marco de página web, puede recuperar el nombre del marco a través de la TargetFrameName propiedad .

Constructores

WebBrowserNavigatingEventArgs(Uri, String)

Inicializa una nueva instancia de la clase WebBrowserNavigatingEventArgs.

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el evento.

(Heredado de CancelEventArgs)
TargetFrameName

Obtiene el nombre del marco de la página Web en el que se cargará el nuevo documento.
Url

Obtiene la ubicación del documento a la que está navegando el control WebBrowser.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también