Sdílet prostřednictvím

WebBrowserNavigatingEventArgs Třída

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll
Zdroj:
WebBrowserNavigatingEventArgs.cs
Zdroj:
WebBrowserNavigatingEventArgs.cs
Zdroj:
WebBrowserNavigatingEventArgs.cs
Zdroj:
WebBrowserNavigatingEventArgs.cs
Zdroj:
WebBrowserNavigatingEventArgs.cs

Poskytuje data pro událost Navigating.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Dědičnost
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Příklady

Následující příklad kódu ukazuje, jak použít obslužnou rutinu WebBrowser.Navigating pro událost zrušit navigaci, když formulář webové stránky nebyl vyplněn. Vlastnost WebBrowser.Document slouží k určení, zda vstupní pole formuláře obsahuje hodnotu. Tento příklad vyžaduje, aby formulář obsahuje ovládací prvek volaný WebBrowserwebBrowser1.

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

Poznámky

Událost WebBrowser.Navigating nastane před přechodem WebBrowser ovládacího prvku do nového dokumentu. Tuto událost můžete zpracovat tak, aby zrušila navigaci dříve, než začne, pokud nebyly splněny určité podmínky, například když uživatel formulář zcela nevyplnil. Chcete-li to provést, nastavte Cancel vlastnost WebBrowserNavigatingEventArgs objektu předaného obslužné rutině události na true. Tento objekt můžete také použít k načtení umístění nového dokumentu prostřednictvím Url vlastnosti. Pokud se nový dokument zobrazí v rámci webové stránky, můžete načíst název rámce prostřednictvím TargetFrameName vlastnosti.

Konstruktory

Name Description
WebBrowserNavigatingEventArgs(Uri, String)

Inicializuje novou instanci WebBrowserNavigatingEventArgs třídy.

Vlastnosti

Name Description
Cancel

Získá nebo nastaví hodnotu určující, zda má být událost zrušena.

(Zděděno od CancelEventArgs)
TargetFrameName

Získá název rámečku webové stránky, ve kterém bude nový dokument načten.
Url

Získá umístění dokumentu, do kterého WebBrowser ovládací prvek přechází.

Metody

Name Description
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také