WebBrowser.DocumentText Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den HTML-Inhalt der im WebBrowser-Steuerelement angezeigten Seite ab oder legt diesen fest.

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

Eigenschaftswert

String

Der HTML-Text der angezeigten Seite oder eine leere Zeichenfolge (""), wenn kein Dokument geladen wurde.

Attribute: BrowsableAttribute

Ausnahmen

ObjectDisposedException

Diese WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

Aus dem zugrunde liegenden ActiveX-IWebBrowser2-Steuerelement konnte kein Verweis auf eine Implementierung der WebBrowser-Schnittstelle abgerufen werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DocumentText -Eigenschaft verwenden, um dokumentbezogene Inhalte Ihrer Wahl programmgesteuert anzuzeigen. Dieses Beispiel erfordert, dass Ihr Formular ein WebBrowser Steuerelement mit dem Namen webBrowser1enthält.

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

Hinweise

Verwenden Sie diese Eigenschaft, wenn Sie den Inhalt einer im WebBrowser Steuerelement angezeigten HTML-Seite mithilfe von Zeichenfolgenverarbeitungstools bearbeiten möchten. Sie können diese Eigenschaft beispielsweise verwenden, um Seiten aus einer Datenbank zu laden oder Seiten mit regulären Ausdrücken zu analysieren. Wenn Sie diese Eigenschaft festlegen, navigiert das WebBrowser Steuerelement automatisch zur url about:blank, bevor der angegebene Text geladen wird. Dies bedeutet, dass die NavigatingEreignisse , Navigatedund DocumentCompleted auftreten, wenn Sie diese Eigenschaft festlegen, und der Wert der Url Eigenschaft ist nicht mehr aussagekräftig.

Hinweis

Diese Eigenschaft enthält den Text des aktuellen Dokuments, auch wenn ein anderes Dokument angefordert wurde. Wenn Sie den Wert dieser Eigenschaft festlegen und ihn dann sofort erneut abrufen, kann sich der abgerufene Wert von dem wertsatz unterscheiden, wenn das WebBrowser Steuerelement keine Zeit zum Laden des neuen Inhalts hatte. Sie können den neuen Wert in einem DocumentCompleted Ereignishandler abrufen. Alternativ können Sie den Thread blockieren, bis das Dokument geladen wird, indem Sie die Thread.Sleep -Methode in einer Schleife aufrufen, bis die DocumentText -Eigenschaft den Wert zurückgibt, auf den Sie ursprünglich festgelegt haben.

Verwenden Sie DocumentStream die -Eigenschaft, um auf den Inhalt einer Webseite als eine Streamzuzugreifen. Sie können auch über die -Eigenschaft über das HTML-Dokumentobjektmodell (DOM) auf die Document Seiteninhalte zugreifen.

Gilt für: