WebBrowser.DocumentText Свойство

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Получает или задает 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 перед загрузкой указанного текста. Это означает, что Navigatingсобытия , Navigatedи DocumentCompleted возникают при установке этого свойства, а значение Url свойства больше не имеет смысла.

Примечание

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

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

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

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