WebBrowser.DocumentText Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia zawartość HTML strony wyświetlanej w kontrolce WebBrowser .

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

Wartość właściwości

String

Tekst HTML wyświetlanej strony lub pusty ciąg ("") w przypadku załadowania dokumentu.

Atrybuty: BrowsableAttribute

Wyjątki

ObjectDisposedException

To WebBrowser wystąpienie nie jest już prawidłowe.

InvalidOperationException

Nie można pobrać odwołania do implementacji interfejsu IWebBrowser2 z bazowego formantu ActiveX WebBrowser .

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą DocumentText właściwości programowo wyświetlać wybraną zawartość dokumentu. Ten przykład wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie 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

Uwagi

Użyj tej właściwości, jeśli chcesz manipulować zawartością strony HTML wyświetlanej w kontrolce WebBrowser przy użyciu narzędzi do przetwarzania ciągów. Tej właściwości można na przykład użyć do ładowania stron z bazy danych lub analizowania stron przy użyciu wyrażeń regularnych. Po ustawieniu tej właściwości kontrolka WebBrowser automatycznie przechodzi do adresu URL about:blank przed załadowaniem określonego tekstu. Oznacza to, że Navigatingzdarzenia , Navigatedi DocumentCompleted występują podczas ustawiania tej właściwości, a wartość Url właściwości nie jest już zrozumiała.

Uwaga

Ta właściwość zawiera tekst bieżącego dokumentu, nawet jeśli zażądano innego dokumentu. Jeśli ustawisz wartość tej właściwości, a następnie natychmiast pobierzesz ją ponownie, pobrana wartość może być inna niż ustawiona wartość, jeśli WebBrowser kontrolka nie miała czasu na załadowanie nowej zawartości. Nową wartość można pobrać w procedurze obsługi zdarzeń DocumentCompleted . Alternatywnie można zablokować wątek do momentu załadowania dokumentu przez wywołanie Thread.Sleep metody w pętli, dopóki DocumentText właściwość nie zwróci wartości, którą pierwotnie ustawiłeś.

Aby uzyskać dostęp do zawartości strony sieci Web jako Streamobiektu , użyj DocumentStream właściwości . Możesz również uzyskać dostęp do zawartości strony przy użyciu modelu obiektów dokumentów HTML (DOM) za pośrednictwem Document właściwości .

Dotyczy