WebBrowserNavigatingEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origine:: WebBrowserNavigatingEventArgs.cs

Origine:: WebBrowserNavigatingEventArgs.cs

Origine:: WebBrowserNavigatingEventArgs.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce i dati per l'evento Navigating.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs

public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs

type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs

Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs

Ereditarietà: Object

EventArgs

CancelEventArgs
WebBrowserNavigatingEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato come usare un gestore per l'evento per annullare lo WebBrowser.Navigating spostamento quando un modulo di pagina Web non è stato compilato. La WebBrowser.Document proprietà viene usata per determinare se il campo di input del modulo contiene un valore. In questo esempio è necessario che il modulo contenga un WebBrowser controllo denominato 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'evento WebBrowser.Navigating si verifica prima che il WebBrowser controllo passi a un nuovo documento. È possibile gestire questo evento per annullare la navigazione prima di iniziare se determinate condizioni non sono state soddisfatte, ad esempio quando l'utente non ha completamente compilato un modulo. A tale scopo, impostare la Cancel proprietà dell'oggetto WebBrowserNavigatingEventArgs passato al gestore eventi su true. È anche possibile usare questo oggetto per recuperare il percorso del nuovo documento tramite la Url proprietà . Se il nuovo documento verrà visualizzato in un frame di pagina Web, è possibile recuperare il nome del frame tramite la TargetFrameName proprietà .

Costruttori

WebBrowserNavigatingEventArgs(Uri, String)

Inizializza una nuova istanza della classe WebBrowserNavigatingEventArgs.

Proprietà

Cancel	Ottiene o imposta un valore che indica se l'evento debba essere annullato. (Ereditato da CancelEventArgs)
TargetFrameName	Ottiene il nome del frame della pagina Web nel quale verrà caricato il nuovo documento.
Url	Ottiene il percorso del documento su cui si sta spostando il controllo WebBrowser.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Condividi tramite