Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
0 von 1 fanden dies hilfreich - Dieses Thema bewerten.

WebBrowser.DocumentText-Eigenschaft

.NET Framework 4

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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
C#
C++
F#
VB
Kopieren 
[BrowsableAttribute(false)]
public string DocumentText { get; set; }

Eigenschaftswert

Typ: System.String
Der HTML-Text der angezeigten Seite oder eine leere Zeichenfolge (""), wenn kein Dokument geladen wurde.
Ausnahme Bedingung
ObjectDisposedException

Diese WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

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

Mit dieser Eigenschaft können Sie den Inhalt einer HTML-Seite, die im WebBrowser-Steuerelement angezeigt wird, mithilfe von Zeichenfolgenverarbeitungstools bearbeiten. Sie können mit dieser Eigenschaft z. B. Seiten aus einer Datenbank laden oder mithilfe regulärer Ausdrücke analysieren. Wenn Sie diese Eigenschaft festlegen, wechselt das WebBrowser-Steuerelement vor dem Laden des angegebenen Textes automatisch zur URL about:blank. Das bedeutet, dass das Festlegen dieser Eigenschaft das Navigating-Ereignis, das Navigated-Ereignis und das DocumentCompleted-Ereignis auslöst und der Wert der Url-Eigenschaft keine Bedeutung mehr hat.

Hinweis 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 diese sofort wieder abrufen, kann der abgerufene Wert vom festgelegten Wert abweichen, wenn das WebBrowser-Steuerelement nicht genügend Zeit zum Laden des neuen Inhalts hatte. Sie können den neuen Wert in einem DocumentCompleted-Ereignishandler abrufen. Alternativ dazu können Sie den Thread blockieren, bis das Dokument geladen ist, indem Sie die Thread.Sleep-Methode in einer Schleife aufrufen, bis die DocumentText-Eigenschaft den Wert zurückgibt, auf den sie ursprünglich festgelegt wurde.

Über die DocumentStream-Eigenschaft erfolgt der Zugriff auf den Inhalt einer Webseite hingegen als Stream. Der Zugriff kann auch unter Verwendung des HTML-Dokumentobjektmodells (DOM) über die Document-Eigenschaft erfolgen.

Im folgenden Codebeispiel wird veranschaulicht, wie ausgewählter Dokumentinhalt mithilfe der DocumentText-Eigenschaft programmgesteuert angezeigt wird. Für dieses Beispiel ist erforderlich, dass das Formular ein WebBrowser-Steuerelement mit dem Namen webBrowser1 enthält.

C#
VB
Kopieren 

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());
    }
}

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Informationen zur Datensicherheit