WebBrowserNavigatingEventArgs Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Daten für das Navigating-Ereignis bereit.

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

public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs

type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs

Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs

Vererbung: Object

EventArgs

CancelEventArgs
WebBrowserNavigatingEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie einen Handler für das Ereignis verwenden, um die WebBrowser.Navigating Navigation abzubrechen, wenn kein Webseitenformular ausgefüllt wurde. Die WebBrowser.Document -Eigenschaft wird verwendet, um zu bestimmen, ob das Formulareingabefeld einen Wert enthält. In diesem Beispiel muss das Formular ein WebBrowser -Steuerelement mit dem Namen webBrowser1enthalten.

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

Hinweise

Das WebBrowser.Navigating Ereignis tritt auf, bevor das WebBrowser Steuerelement zu einem neuen Dokument navigiert. Sie können dieses Ereignis behandeln, um die Navigation abzubrechen, bevor es beginnt, wenn bestimmte Bedingungen nicht erfüllt wurden, z. B. wenn der Benutzer ein Formular nicht vollständig ausgefüllt hat. Legen Sie dazu die Cancel -Eigenschaft des -Objekts, das WebBrowserNavigatingEventArgs an den Ereignishandler übergeben wird, auf fest true. Sie können dieses Objekt auch verwenden, um den Speicherort des neuen Dokuments über die Url -Eigenschaft abzurufen. Wenn das neue Dokument in einem Webseitenframe angezeigt wird, können Sie den Namen des Frames über die TargetFrameName -Eigenschaft abrufen.

Konstruktoren

WebBrowserNavigatingEventArgs(Uri, String)

Initialisiert eine neue Instanz der WebBrowserNavigatingEventArgs-Klasse.

Eigenschaften

Cancel	Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest. (Geerbt von CancelEventArgs)
TargetFrameName	Ruft den Namen des Webseitenframes ab, in den das neue Dokument geladen wird.
Url	Ruft den Speicherort des Dokuments ab, zu dem das WebBrowser-Steuerelement navigiert.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: