WebBrowser.Navigating Evento

Definición

Se produce antes de que el control WebBrowser navegue hasta un nuevo documento.Occurs before the WebBrowser control navigates to a new document.

public:
 event System::Windows::Forms::WebBrowserNavigatingEventHandler ^ Navigating;
public event System.Windows.Forms.WebBrowserNavigatingEventHandler Navigating;
member this.Navigating : System.Windows.Forms.WebBrowserNavigatingEventHandler 
Public Custom Event Navigating As WebBrowserNavigatingEventHandler 

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un controlador para el evento Navigating para cancelar la navegación cuando no se ha rellenado un formulario de página web.The following code example demonstrates how to use a handler for the Navigating event to cancel navigation when a Web page form has not been filled in. La propiedad Document se utiliza para determinar si el campo de entrada de formulario contiene un valor.The Document property is used to determine whether the form input field contains a value.

En este ejemplo se requiere que el formulario contenga un control WebBrowser denominado webBrowser1 y que la clase de formulario tenga un ComVisibleAttribute haciendo que sea accesible para COM.This example requires that your form contains a WebBrowser control called webBrowser1 and that your form class has a ComVisibleAttribute making it accessible to COM.

Para obtener un ejemplo de código completo en el que puede pegar el código siguiente, consulte Cómo: agregar funcionalidades del explorador Web a una aplicación Windows Forms.For a complete code example that you can paste the following code into, see How to: Add Web Browser Capabilities to a Windows Forms Application.

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 control WebBrowser navega a un nuevo documento cada vez que se establece una de las siguientes propiedades o se llama a métodos:The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

Puede controlar el evento Navigating para cancelar la navegación si no se cumplen ciertas condiciones, por ejemplo, cuando el usuario no ha rellenado completamente un formulario.You can handle the Navigating event to cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Para cancelar la navegación, establezca la propiedad Cancel del WebBrowserNavigatingEventArgs objeto pasado al controlador de eventos en true.To cancel navigation, set the Cancel property of the WebBrowserNavigatingEventArgs object passed to the event handler to true. También puede utilizar este objeto para recuperar la dirección URL del nuevo documento a través de la propiedad WebBrowserNavigatingEventArgs.Url.You can also use this object to retrieve the URL of the new document through the WebBrowserNavigatingEventArgs.Url property. Si el nuevo documento se va a mostrar en un marco de página web, puede recuperar el nombre del marco a través de la propiedad WebBrowserNavigatingEventArgs.TargetFrameName.If the new document will be displayed in a Web page frame, you can retrieve the name of the frame through the WebBrowserNavigatingEventArgs.TargetFrameName property.

Controle el evento Navigated para recibir una notificación cuando el control de WebBrowser finalice la navegación y haya empezado a cargar el documento en la nueva ubicación.Handle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location. Controle el evento DocumentCompleted para recibir una notificación cuando el control de WebBrowser termine de cargar el nuevo documento.Handle the DocumentCompleted event to receive notification when the WebBrowser control finishes loading the new document.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Seguridad

SecurityPermission
para que los llamadores inmediatos utilicen este control.for immediate callers to use this control. Valor de petición: LinkDemand; Conjuntos de permisos con nombre: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Se aplica a

Consulte también: