WebBrowserNavigatingEventArgs Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia dane dla zdarzenia Navigating.

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

public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs

type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs

Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs

Dziedziczenie: Object

EventArgs

CancelEventArgs
WebBrowserNavigatingEventArgs

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć procedury obsługi dla WebBrowser.Navigating zdarzenia, aby anulować nawigację, gdy formularz strony sieci Web nie został wypełniony. Właściwość WebBrowser.Document służy do określania, czy pole wejściowe formularza zawiera wartość. Ten przykład wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie 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

Uwagi

Zdarzenie WebBrowser.Navigating występuje przed przejściem kontrolki WebBrowser do nowego dokumentu. To zdarzenie można obsłużyć, aby anulować nawigację przed rozpoczęciem, jeśli nie zostały spełnione określone warunki, na przykład gdy użytkownik nie wypełnił całkowicie formularza. W tym celu ustaw Cancel właściwość WebBrowserNavigatingEventArgs obiektu przekazanego do procedury obsługi zdarzeń na true. Możesz również użyć tego obiektu, aby pobrać lokalizację nowego dokumentu za pomocą Url właściwości . Jeśli nowy dokument zostanie wyświetlony w ramce strony sieci Web, możesz pobrać nazwę ramki za pomocą TargetFrameName właściwości .

Konstruktory

WebBrowserNavigatingEventArgs(Uri, String)

Inicjuje nowe wystąpienie klasy WebBrowserNavigatingEventArgs.

Właściwości

Cancel	Pobiera lub ustawia wartość wskazującą, czy zdarzenie powinno zostać anulowane. (Odziedziczone po CancelEventArgs)
TargetFrameName	Pobiera nazwę ramki strony sieci Web, w której zostanie załadowany nowy dokument.
Url	Pobiera lokalizację dokumentu, do którego nawiguje kontrolka WebBrowser .

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy