Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

WebBrowserNavigatingEventHandler-Delegat

Aktualisiert: November 2007

Stellt die Methode dar, die das WebBrowser.Navigating-Ereignis eines WebBrowser-Steuerelements behandelt.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public delegate void WebBrowserNavigatingEventHandler(
	Object sender,
	WebBrowserNavigatingEventArgs e
)
/** @delegate */
public delegate void WebBrowserNavigatingEventHandler(
	Object sender,
	WebBrowserNavigatingEventArgs e
)
JScript unterstützt keine Delegaten.

Parameter

sender
Typ: System.Object
Die Quelle des Ereignisses.
e
Typ: System.Windows.Forms.WebBrowserNavigatingEventArgs
Ein WebBrowserNavigatingEventArgs, das die Ereignisdaten enthält.

Beim Erstellen eines WebBrowserNavigatingEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen über Ereignishandlerdelegaten finden Sie unter Ereignisse und Delegaten.

Im folgenden Codebeispiel wird die Verwendung eines Handlers für das WebBrowser.Navigating-Ereignis veranschaulicht, um die Navigation abzubrechen, wenn ein Webseitenformular nicht ausgefüllt wurde. Mit der WebBrowser.Document-Eigenschaft wird bestimmt, ob das Eingabefeld des Formulars einen Wert enthält. Für dieses Beispiel ist erforderlich, dass das Formular ein WebBrowser-Steuerelement mit dem Namen webBrowser1 enthält.

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());
    }
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0
Anzeigen: