WebBrowser.DocumentText Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает 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, setPublic Property DocumentText As StringЗначение свойства
HTML-текст отображаемой страницы или пустая строка (""), если никакой документ не загружен.
- Атрибуты
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса 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 свойство .
