WebBrowser.DocumentText 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.
Dient zum Abrufen oder Festlegen des HTML-Inhalts der Seite, die WebBrowser im Steuerelement angezeigt wird.
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, setPublic Property DocumentText As StringEigenschaftswert
Der HTML-Text der angezeigten Seite oder die leere Zeichenfolge ("") wenn kein Dokument 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 DocumentText Eigenschaft zum programmgesteuerten Anzeigen von Dokumentinhalten Ihrer Wahl verwendet wird. 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 den Inhalt einer IM WebBrowser STEUERELEMENT angezeigten HTML-Seite mithilfe von Zeichenfolgenverarbeitungstools bearbeiten möchten. Mit dieser Eigenschaft können Sie z. B. Seiten aus einer Datenbank laden oder Seiten mithilfe regulärer Ausdrücke analysieren. Wenn Sie diese Eigenschaft festlegen, navigiert das WebBrowser Steuerelement automatisch zur about:blank-URL, bevor der angegebene Text geladen wird. Dies bedeutet, dass die NavigatingEreignisse Navigatedund DocumentCompleted Ereignisse 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 der abgerufene Wert vom Wert abweichen, der festgelegt wurde, 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 sie ursprünglich festgelegt haben.
Verwenden Sie die DocumentStream Eigenschaft, um auf den Inhalt einer Webseite als a Streamzuzugreifen. Sie können auch über die Document Eigenschaft mithilfe des HTML-Dokumentobjektmodells (DOM) auf den Seiteninhalt zugreifen.
