Esta documentación está archivada y no tiene mantenimiento.

WebBrowser.Navigating (Evento)

Se produce antes que el control WebBrowser se desplace hasta un nuevo documento.

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

public event WebBrowserNavigatingEventHandler Navigating
/** @event */
public void add_Navigating (WebBrowserNavigatingEventHandler value)

/** @event */
public void remove_Navigating (WebBrowserNavigatingEventHandler value)

En JScript, se pueden controlar los eventos que define una clase, pero no se pueden definir unos propios.
No aplicable.

El control WebBrowser se desplaza hasta un nuevo documento cuando se establece una de las siguientes propiedades o se llama a uno de los siguientes métodos:

Puede controlar el evento Navigating para cancelar la exploración si no se han cumplido algunas condiciones, por ejemplo, cuando el usuario no ha rellenado totalmente un formulario. Para cancelar la exploración, establezca la propiedad Cancel del objetoWebBrowserNavigatingEventArgs pasado al controlador de eventos en true. También puede utilizar este objeto para recuperar la dirección URL del nuevo documento mediante la propiedad WebBrowserNavigatingEventArgs.Url. Si el nuevo documento se va a mostrar en un marco de página Web, puede recuperar el nombre del marco mediante la propiedad WebBrowserNavigatingEventArgs.TargetFrameName.

Controle el evento Navigated para recibir una notificación cuando el control WebBrowser finalice la exploración y haya empezado a cargar el documento en la nueva ubicación. Controle el evento DocumentCompleted para recibir una notificación cuando el control WebBrowser termine de cargar el nuevo documento.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

En el ejemplo de código siguiente se muestra el uso de un controlador del evento Navigating para cancelar la exploración cuando no se haya rellenado un formulario de página Web. La propiedad 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 y que la clase del formulario tenga un ComVisibleAttribute que le haga accesible para COM.

Para obtener un ejemplo de código completo que puede pegar en el código siguiente, vea Cómo: Agregar funciones de explorador Web a una aplicación de Windows Forms.

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

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

.NET Compact Framework

Compatible con: 2.0
Mostrar: