WebBrowserNavigatingEventArgs Clase

Definición

Proporciona datos para el evento Navigating.Provides data for the Navigating event.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Herencia
WebBrowserNavigatingEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un controlador WebBrowser.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 WebBrowser.Navigating event to cancel navigation when a Web page form has not been filled in. La WebBrowser.Document propiedad se usa para determinar si el campo de entrada de formulario contiene un valor.The WebBrowser.Document property is used to determine whether the form input field contains a value. Este ejemplo requiere que el formulario contenga WebBrowser un control webBrowser1denominado.This example requires that your form contains a WebBrowser control called 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());
    }
}
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.Navigating evento tiene lugar antes WebBrowser de que el control navegue hasta un nuevo documento.The WebBrowser.Navigating event occurs before the WebBrowser control navigates to a new document. Puede controlar este evento para cancelar la navegación antes de que se inicie si no se cumplen ciertas condiciones, por ejemplo, cuando el usuario no ha rellenado completamente un formulario.You can handle this event to cancel navigation before it begins if certain conditions have not been met, for example, when the user has not completely filled out a form. Para ello, establezca la Cancel propiedad WebBrowserNavigatingEventArgs del objeto pasado al controlador de eventos en true.To do this, set the Cancel property of the WebBrowserNavigatingEventArgs object passed to the event handler to true. También puede utilizar este objeto para recuperar la ubicación del nuevo documento a través de la Url propiedad.You can also use this object to retrieve the location of the new document through the 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 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 TargetFrameName property.

Constructores

WebBrowserNavigatingEventArgs(Uri, String)

Inicializa una nueva instancia de la clase WebBrowserNavigatingEventArgs.Initializes a new instance of the WebBrowserNavigatingEventArgs class.

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el evento.Gets or sets a value indicating whether the event should be canceled.

(Heredado de CancelEventArgs)
TargetFrameName

Obtiene el nombre del marco de la página Web en el que se cargará el nuevo documento.Gets the name of the Web page frame in which the new document will be loaded.

Url

Obtiene la ubicación del documento a la que está navegando el control WebBrowser.Gets the location of the document to which the WebBrowser control is navigating.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: