Sdílet prostřednictvím

WebBrowser.DocumentText Vlastnost

  • Reference

Definice

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

Získá nebo nastaví obsah HTML 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 ze základní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 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

Tuto vlastnost použijte, pokud chcete manipulovat 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 už nemá smysl.

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 pak ji okamžitě znovu načtete, může se načtená hodnota lišit od nastavené hodnoty, pokud WebBrowser ovládací prvek neměl čas na načtení nového obsahu. Novou hodnotu můžete načíst v obslužné rutině DocumentCompleted události. Případně můžete blokovat vlákno až do načtení dokumentu voláním Thread.Sleep metody ve smyčce, dokud DocumentText vlastnost nevrátí hodnotu, na kterou jste původně nastavili.

Chcete-li získat přístup k obsahu webové stránky jako Stream, 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

Viz také