WebBrowser.DocumentText Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia zawartość HTML strony wyświetlanej w kontrolce WebBrowser .
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 StringWartość właściwości
Tekst HTML wyświetlanej strony lub pusty ciąg (""), jeśli żaden dokument nie zostanie załadowany.
- Atrybuty
Wyjątki
To WebBrowser wystąpienie nie jest już prawidłowe.
Nie można pobrać odwołania do implementacji interfejsu IWebBrowser2 z bazowego formantu ActiveX WebBrowser .
Przykłady
Poniższy przykład kodu pokazuje, jak za pomocą DocumentText właściwości programowo wyświetlać wybraną zawartość dokumentu. Ten przykład wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie 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
Uwagi
Użyj tej właściwości, jeśli chcesz manipulować zawartością strony HTML wyświetlanej w kontrolce WebBrowser przy użyciu narzędzi przetwarzania ciągów. Za pomocą tej właściwości można na przykład ładować strony z bazy danych lub analizować strony przy użyciu wyrażeń regularnych. Po ustawieniu tej właściwości kontrolka WebBrowser automatycznie przechodzi do adresu URL about:blank przed załadowaniem określonego tekstu. Oznacza to, że Navigatingzdarzenia , Navigatedi DocumentCompleted występują podczas ustawiania tej właściwości, a wartość Url właściwości nie jest już zrozumiała.
Uwaga / Notatka
Ta właściwość zawiera tekst bieżącego dokumentu, nawet jeśli zażądano innego dokumentu. Jeśli ustawisz wartość tej właściwości, a następnie natychmiast pobierzesz ją ponownie, pobrana wartość może być inna niż ustawiona wartość, jeśli WebBrowser kontrolka nie miała czasu na załadowanie nowej zawartości. Nową wartość można pobrać w procedurze obsługi zdarzeń DocumentCompleted . Alternatywnie można zablokować wątek do momentu załadowania dokumentu przez wywołanie Thread.Sleep metody w pętli, dopóki DocumentText właściwość nie zwróci pierwotnie ustawionej wartości.
Aby uzyskać dostęp do zawartości strony sieci Web jako elementu Stream, użyj DocumentStream właściwości . Dostęp do zawartości strony można również uzyskać przy użyciu modelu obiektów dokumentów HTML (DOM) za pomocą Document właściwości .
