WebBrowser.Document Eigenschaft

Definition

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

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

Attribute

Ausnahmen

Diese WebBrowser-Instanz ist nicht mehr gültig.

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:

Weitere Informationen