WebBrowserNavigatingEventArgs Klass

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Innehåller data för Navigating händelsen.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Arv
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Exempel

Följande kodexempel visar hur du använder en hanterare för händelsen för att avbryta navigeringen WebBrowser.Navigating när ett webbsideformulär inte har fyllts i. Egenskapen WebBrowser.Document används för att avgöra om formulärets indatafält innehåller ett värde. Det här exemplet kräver att formuläret innehåller en WebBrowser kontroll med namnet 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

Kommentarer

Händelsen WebBrowser.Navigating inträffar innan kontrollen WebBrowser navigerar till ett nytt dokument. Du kan hantera den här händelsen för att avbryta navigeringen innan den börjar om vissa villkor inte har uppfyllts, till exempel när användaren inte har fyllt i ett formulär helt. Det gör du genom att ange Cancel egenskapen för objektet som WebBrowserNavigatingEventArgs skickas till händelsehanteraren till true. Du kan också använda det här objektet för att hämta platsen för det nya dokumentet via Url egenskapen . Om det nya dokumentet visas i en webbplatsram kan du hämta namnet på ramen via egenskapen TargetFrameName .

Konstruktorer

Name Description
WebBrowserNavigatingEventArgs(Uri, String)

Initierar en ny instans av WebBrowserNavigatingEventArgs klassen.

Egenskaper

Name Description
Cancel

Hämtar eller anger ett värde som anger om händelsen ska avbrytas.

(Ärvd från CancelEventArgs)
TargetFrameName

Hämtar namnet på webbsideramen där det nya dokumentet läses in.
Url

Hämtar platsen för dokumentet som WebBrowser kontrollen navigerar till.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även