WebBrowser.Document Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
HtmlDocument Получает представление веб-страницы, отображаемой в данный момент в элементе WebBrowser управления.
public:
property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument? Document { get; }[<System.ComponentModel.Browsable(false)>]
member this.Document : System.Windows.Forms.HtmlDocumentPublic ReadOnly Property Document As HtmlDocumentЗначение свойства
Представляет HtmlDocument текущую страницу или null не загружается.
- Атрибуты
Исключения
Этот WebBrowser экземпляр больше недействителен.
Не удалось получить ссылку на реализацию IWebBrowser2 интерфейса из базового элемента управления ActiveX WebBrowser .
Примеры
В следующем примере кода показано, как использовать Document свойство в обработчике Navigating события, чтобы определить, заполнена ли форма веб-страницы. Если поле ввода не содержит значения, навигация отменяется.
В этом примере требуется, чтобы форма содержала 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
Комментарии
Используйте это свойство, если вы хотите получить доступ к содержимому веб-страницы, отображаемой в элементе WebBrowser управления с помощью объектной модели HTML-документа (DOM). Это полезно, например, если вы хотите использовать веб-элементы управления в приложении Windows Forms.
Это свойство можно использовать в сочетании со ObjectForScripting свойством для реализации двустороннего взаимодействия между веб-страницей, отображаемой в элементе WebBrowser управления и приложении.
HtmlDocument.InvokeScript Используйте метод для вызова методов скрипта, реализованных на веб-странице из кода клиентского приложения. Код скриптов может получить доступ к приложению через window.external объект, который является встроенным объектом DOM, предоставленным для доступа к узлу, и который сопоставляется с объектом, указанным для ObjectForScripting свойства.
Чтобы получить доступ к содержимому веб-страницы в виде строки, используйте DocumentText это свойство. Чтобы получить доступ к содержимому веб-страницы в качестве Streamсвойства, используйте DocumentStream это свойство.
