WebBrowser.Document 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 ein HtmlDocument ab, das die gegenwärtig im WebBrowser-Steuerelement angezeigte Webseite darstellt.

public:
 property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument? Document { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Document : System.Windows.Forms.HtmlDocument

Public ReadOnly Property Document As HtmlDocument

Eigenschaftswert

HtmlDocument

Ein HtmlDocument, das die aktuelle Seite darstellt, oder null, wenn keine Seite geladen ist.

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 die Document -Eigenschaft in einem Handler für das Navigating Ereignis verwendet wird, um zu bestimmen, ob ein Webseitenformular ausgefüllt wurde. Wenn das Eingabefeld keinen Wert enthält, wird die Navigation abgebrochen.

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 über das HTML-Dokumentobjektmodell (DOM) auf den Inhalt einer Webseite zugreifen möchten, die WebBrowser im Steuerelement angezeigt wird. Dies ist beispielsweise nützlich, wenn Sie webbasierte Steuerelemente in Ihrer Windows Forms-Anwendung verwenden möchten.

Sie können diese Eigenschaft in Kombination mit der -Eigenschaft verwenden, um die ObjectForScripting bidirektionale Kommunikation zwischen einer im WebBrowser Steuerelement angezeigten Webseite und Ihrer Anwendung zu implementieren. Verwenden Sie die HtmlDocument.InvokeScript -Methode, um Skriptmethoden aufzurufen, die in einer Webseite aus dem Code Ihrer Clientanwendung implementiert sind. Ihr Skriptcode kann über das window.external -Objekt auf Ihre Anwendung zugreifen. Hierbei handelt es sich um ein integriertes DOM-Objekt, das für den Hostzugriff bereitgestellt wird und einem Objekt zugeordnet ist, das Sie für die ObjectForScripting Eigenschaft angeben.

Verwenden Sie DocumentText die -Eigenschaft, um auf den Inhalt einer Webseite als Zeichenfolge zuzugreifen. Verwenden Sie DocumentStream die -Eigenschaft, um auf den Inhalt einer Webseite als eine Streamzuzugreifen.

Gilt für:

Freigeben über