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

WebBrowserNavigatingEventArgs (Clase)

Proporciona datos para el evento WebBrowser.Navigating.

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

public class WebBrowserNavigatingEventArgs : CancelEventArgs
public class WebBrowserNavigatingEventArgs extends CancelEventArgs
public class WebBrowserNavigatingEventArgs extends CancelEventArgs
No aplicable.

El evento WebBrowser.Navigating aparece antes de que el control WebBrowser se desplace a un nuevo documento. Puede controlar este evento para cancelar el desplazamiento antes de que comience si no se han cumplido ciertas condiciones, por ejemplo, si el usuario no ha rellenado completamente un formulario. Para ello, establezca la propiedad Cancel del objeto WebBrowserNavigatingEventArgs pasada al controlador de eventos a true. También puede utilizar este objeto para recuperar la ubicación del nuevo documento mediante la propiedad Url. Si el nuevo documento se va a mostrar en un marco de la página Web, puede recuperar el nombre del marco mediante la propiedad TargetFrameName.

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.

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

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Windows.Forms.WebBrowserNavigatingEventArgs

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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: