Поделиться через

WebBrowser.DocumentText Свойство

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs
Исходный код:
WebBrowser.cs

Возвращает или задает HTML-содержимое страницы, отображаемой в элементе 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, set
Public Property DocumentText As String

Значение свойства

String

HTML-текст отображаемой страницы или пустая строка (""), если документ не загружен.

Атрибуты
BrowsableAttribute

Исключения

ObjectDisposedException

Этот WebBrowser экземпляр больше недействителен.

InvalidOperationException

Не удалось получить ссылку на реализацию IWebBrowser2 интерфейса из базового элемента управления ActiveX WebBrowser .

Примеры

В следующем примере кода показано, как использовать DocumentText свойство для программного отображения содержимого документа выбранного варианта. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления с именем 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

Комментарии

Используйте это свойство, если вы хотите управлять содержимым HTML-страницы, отображаемой в элементе WebBrowser управления, с помощью средств обработки строк. Это свойство можно использовать, например, для загрузки страниц из базы данных или анализа страниц с помощью регулярных выражений. При установке этого свойства WebBrowser элемент управления автоматически переходит к URL-адресу about:blank перед загрузкой указанного текста. Это означает, что NavigatingNavigatedсобытия и DocumentCompleted события происходят при установке этого свойства, а значение Url свойства больше не имеет значения.

Замечание

Это свойство содержит текст текущего документа, даже если запрашивается другой документ. Если задать значение этого свойства, а затем сразу же получить его снова, то полученное значение может отличаться от значения, если WebBrowser элемент управления не имел времени для загрузки нового содержимого. Вы можете получить новое значение в обработчике DocumentCompleted событий. Кроме того, можно заблокировать поток, пока документ не будет загружен, вызвав Thread.Sleep метод в цикле, пока свойство не DocumentText вернет значение, которое изначально задано.

Чтобы получить доступ к содержимому веб-страницы в качестве Streamсвойства, используйте DocumentStream это свойство. Вы также можете получить доступ к содержимому страницы с помощью объектной модели HTML-документа (DOM) через Document свойство.

Применяется к

См. также раздел