WebBrowser.DocumentText Vlastnost

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í.

Získá nebo nastaví html obsah stránky zobrazené v ovládacím WebBrowser prvku.

public:
 property System::String ^ DocumentText { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string DocumentText { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DocumentText : string with get, set

Public Property DocumentText As String

Hodnota vlastnosti

String

Text HTML zobrazené stránky nebo prázdný řetězec (""), pokud není načten žádný dokument.

Atributy: BrowsableAttribute

Výjimky

ObjectDisposedException

Tato WebBrowser instance již není platná.

InvalidOperationException

Odkaz na implementaci IWebBrowser2 rozhraní nelze načíst z podkladového ovládacího prvku ActiveX WebBrowser .

Příklady

Následující příklad kódu ukazuje, jak použít DocumentText vlastnost k programovému zobrazení obsahu dokumentu podle vašeho výběru. Tento příklad vyžaduje, aby formulář obsahoval ovládací prvek WebBrowser 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

Tuto vlastnost použijte, pokud chcete pracovat s obsahem stránky HTML zobrazené v ovládacím WebBrowser prvku pomocí nástrojů pro zpracování řetězců. Tuto vlastnost můžete použít například k načtení stránek z databáze nebo k analýze stránek pomocí regulárních výrazů. Když nastavíte tuto vlastnost, ovládací prvek před načtením zadaného WebBrowser textu automaticky přejde na adresu URL about:blank. To znamená, že Navigatingudálosti , Navigateda DocumentCompleted nastanou při nastavení této vlastnosti a hodnota Url vlastnosti již není smysluplná.

Poznámka

Tato vlastnost obsahuje text aktuálního dokumentu, i když byl požadován jiný dokument. Pokud nastavíte hodnotu této vlastnosti a okamžitě ji znovu načtete, může se načtená hodnota lišit od nastavené hodnoty, pokud WebBrowser ovládací prvek neměl čas načíst nový obsah. Novou hodnotu můžete načíst v obslužné rutině DocumentCompleted události. Případně můžete blokovat vlákno, dokud dokument není načten voláním Thread.Sleep metody ve smyčce, dokud DocumentText vlastnost nevrátí hodnotu, na kterou jste ji původně nastavili.

Chcete-li získat přístup k obsahu webové stránky jako Streamobjekt , použijte DocumentStream vlastnost . K obsahu stránky můžete přistupovat také pomocí modelu DOM (Document Object Model) HTML prostřednictvím Document vlastnosti .

Platí pro