WebBrowserNavigatingEventArgs Classe

Definizione

Fornisce dati per l'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
Ereditarietà
WebBrowserNavigatingEventArgs

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare un gestore per l' WebBrowser.Navigating evento per annullare la navigazione quando non è stato compilato un modulo della pagina 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 proprietà viene utilizzata per determinare se il campo di input del form contiene un valore.The WebBrowser.Document property is used to determine whether the form input field contains a value. Questo esempio richiede che il form contenga un WebBrowser controllo denominato webBrowser1 .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

Commenti

L' WebBrowser.Navigating evento si verifica prima WebBrowser che il controllo venga spostato in un nuovo documento.The WebBrowser.Navigating event occurs before the WebBrowser control navigates to a new document. È possibile gestire questo evento per annullare la navigazione prima che inizi se non sono state soddisfatte determinate condizioni, ad esempio quando l'utente non ha compilato completamente un modulo.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. A tale scopo, impostare la Cancel proprietà dell' WebBrowserNavigatingEventArgs oggetto passato al gestore eventi su true .To do this, set the Cancel property of the WebBrowserNavigatingEventArgs object passed to the event handler to true. È anche possibile usare questo oggetto per recuperare il percorso del nuovo documento tramite la Url Proprietà.You can also use this object to retrieve the location of the new document through the Url property. Se il nuovo documento viene visualizzato in un frame di pagina Web, è possibile recuperare il nome del frame tramite la TargetFrameName Proprietà.If the new document will be displayed in a Web page frame, you can retrieve the name of the frame through the TargetFrameName property.

Costruttori

WebBrowserNavigatingEventArgs(Uri, String)

Inizializza una nuova istanza della classe WebBrowserNavigatingEventArgs.Initializes a new instance of the WebBrowserNavigatingEventArgs class.

Proprietà

Cancel

Ottiene o imposta un valore che indica se l'evento debba essere annullato.Gets or sets a value indicating whether the event should be canceled.

(Ereditato da CancelEventArgs)
TargetFrameName

Ottiene il nome del frame della pagina Web nel quale verrà caricato il nuovo documento.Gets the name of the Web page frame in which the new document will be loaded.

Url

Ottiene il percorso del documento su cui si sta spostando il controllo WebBrowser.Gets the location of the document to which the WebBrowser control is navigating.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche