Udostępnij za pośrednictwem

WebBrowserNavigatingEventArgs Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

Zobacz też