WebBrowser.Document Eigenschaft
Definition
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 eine HtmlDocument Darstellung der Webseite ab, die WebBrowser derzeit im Steuerelement angezeigt wird.
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.HtmlDocumentPublic ReadOnly Property Document As HtmlDocumentEigenschaftswert
Eine HtmlDocument Darstellung der aktuellen Seite oder null wenn keine Seite geladen wird.
- Attribute
Ausnahmen
Diese WebBrowser Instanz ist nicht mehr gültig.
Ein Verweis auf eine Implementierung der IWebBrowser2 Schnittstelle konnte nicht aus dem zugrunde liegenden ActiveX-Steuerelement WebBrowser 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.
In diesem Beispiel muss das Formular ein WebBrowser Steuerelement enthalten, das aufgerufen wird 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
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 hilfreich, wenn Sie webbasierte Steuerelemente in Ihrer Windows Forms-Anwendung verwenden möchten.
Sie können diese Eigenschaft in Kombination mit der ObjectForScripting Eigenschaft verwenden, um die bidirektionale Kommunikation zwischen einer Webseite zu implementieren, die WebBrowser im Steuerelement und ihrer Anwendung angezeigt wird. Verwenden Sie die HtmlDocument.InvokeScript Methode, um Skriptmethoden aufzurufen, die in einer Webseite von Ihrem Clientanwendungscode implementiert sind. Ihr Skriptcode kann über das window.external Objekt, das ein integriertes DOM-Objekt ist, das für den Hostzugriff bereitgestellt wird, auf Ihre Anwendung zugreifen und einem Objekt zugeordnet werden, das Sie für die ObjectForScripting Eigenschaft angeben.
Verwenden Sie die DocumentText Eigenschaft, um auf den Inhalt einer Webseite als Zeichenfolge zuzugreifen. Verwenden Sie die DocumentStream Eigenschaft, um auf den Inhalt einer Webseite als a Streamzuzugreifen.
