Condividi tramite

WebBrowserNavigatingEventArgs Classe

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
WebBrowserNavigatingEventArgs.cs
Origine:
WebBrowserNavigatingEventArgs.cs
Origine:
WebBrowserNavigatingEventArgs.cs
Origine:
WebBrowserNavigatingEventArgs.cs
Origine:
WebBrowserNavigatingEventArgs.cs

Fornisce 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 utilizzare un gestore per l'evento per annullare la WebBrowser.Navigating navigazione quando non è stato compilato un modulo di pagina Web. La WebBrowser.Document proprietà viene utilizzata per determinare se il campo di input del modulo contiene un valore. In questo esempio è necessario che il form 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 che inizi se determinate condizioni non sono state soddisfatte, ad esempio quando l'utente non ha compilato completamente un modulo. A tale scopo, impostare la Cancel proprietà dell'oggetto WebBrowserNavigatingEventArgs passato al gestore eventi su true. È anche possibile utilizzare questo oggetto per recuperare la posizione 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

Nome Descrizione
WebBrowserNavigatingEventArgs(Uri, String)

Inizializza una nuova istanza della classe WebBrowserNavigatingEventArgs.

Proprietà

Nome Descrizione
Cancel

Ottiene o imposta un valore che indica se l'evento deve essere annullato.

(Ereditato da CancelEventArgs)
TargetFrameName

Ottiene il nome della cornice della pagina Web in cui verrà caricato il nuovo documento.
Url

Ottiene la posizione del documento in cui si sta spostando il WebBrowser controllo.

Metodi

Nome Descrizione
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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche