WebBrowserNavigatingEventHandler (Delegado) (System.Windows.Forms)

Cambiar vista:

Clásica

Ligera

Sin script

Comentario del sitio

Biblioteca de clases de .NET Framework

WebBrowserNavigatingEventHandler (Delegado)

Actualización: noviembre 2007

Representa el método que controlará el evento WebBrowser.Navigating de un control WebBrowser.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)

Sintaxis

Visual Basic (Declaración)

Public Delegate Sub WebBrowserNavigatingEventHandler ( _
	sender As Object, _
	e As WebBrowserNavigatingEventArgs _
)

Visual Basic (Uso)

Dim instance As New WebBrowserNavigatingEventHandler(AddressOf HandlerMethod)

public delegate void WebBrowserNavigatingEventHandler(
	Object sender,
	WebBrowserNavigatingEventArgs e
)

Visual C++

public delegate void WebBrowserNavigatingEventHandler(
	Object^ sender, 
	WebBrowserNavigatingEventArgs^ e
)

/** @delegate */
public delegate void WebBrowserNavigatingEventHandler(
	Object sender,
	WebBrowserNavigatingEventArgs e
)

JScript

JScript no admite delegados.

Parámetros

sender: Tipo: System.Object
Origen del evento.

e: Tipo: System.Windows.Forms.WebBrowserNavigatingEventArgs
WebBrowserNavigatingEventArgs que contiene los datos del evento.

Comentarios

Cuando se crea un delegado WebBrowserNavigatingEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador de eventos, se debe agregar al evento una instancia del delegado. Siempre que se produzca el evento, se llamará al controlador del evento, a menos que se quite el delegado. Para obtener más información acerca de los delegados del controlador de eventos, vea Eventos y delegados.

Ejemplos

El ejemplo de código siguiente muestra cómo utilizar un controlador para el evento WebBrowser.Navigating para cancelar el desplazamiento si el formulario de página Web no se ha rellenado. La propiedad WebBrowser.Document se utiliza para determinar si el campo de entrada de formulario contiene un valor. En este ejemplo se requiere que el formulario contenga un control WebBrowser denominado webBrowser1.

Visual Basic

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

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());
    }
}

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.5, 3.0, 2.0

.NET Compact Framework

Compatible con: 3.5, 2.0

Vea también

Referencia

System.Windows.Forms (Espacio de nombres)

WebBrowser

WebBrowser.Navigating

WebBrowserNavigatingEventArgs

Otros recursos

Eventos y delegados