WebBrowserNavigatingEventArgs Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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, pokud 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ář obsahoval WebBrowser ovládací prvek s názvem 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

Poznámky

Událost WebBrowser.Navigating nastane předtím, než WebBrowser ovládací prvek přejde do nového dokumentu. Tuto událost můžete zpracovat tak, aby zrušila navigaci před jejím zahájením, pokud nebyly splněny určité podmínky, například když uživatel zcela nevyplnil formulář. Chcete-li to provést, nastavte Cancel vlastnost objektu WebBrowserNavigatingEventArgs předanou obslužné rutině události na truehodnotu . 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 název rámce načíst prostřednictvím TargetFrameName vlastnosti .

Konstruktory

WebBrowserNavigatingEventArgs(Uri, String)

Inicializuje novou instanci WebBrowserNavigatingEventArgs třídy .

Vlastnosti

Cancel	Získá nebo nastaví hodnotu označující, zda má být událost zrušena. (Zděděno od CancelEventArgs)
TargetFrameName	Získá název rámce webové stránky, ve kterém bude načten nový dokument.
Url	Získá umístění dokumentu, do kterého WebBrowser ovládací prvek přejde.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro