WebBrowser.Navigating Evento

Definición

Se produce antes 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 Navigating para que el evento cancele 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 Document propiedad se usa 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 WebBrowser contenga webBrowser1 un control denominado y que la clase ComVisibleAttribute de formulario tenga una 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 How to: Agregar capacidades del explorador Web a una aplicaciónWindows 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 WebBrowser control 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 Cancel la propiedad WebBrowserNavigatingEventArgs del 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 WebBrowserNavigatingEventArgs.Url la propiedad.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 WebBrowserNavigatingEventArgs.TargetFrameName de la propiedad.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 Navigated el evento para recibir una notificación WebBrowser cuando el control 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 DocumentCompleted el evento para recibir una notificación WebBrowser cuando el control 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: