获取一个 HtmlDocument,它表示当前显示在 WebBrowser 控件中的网页。
命名空间: System.Windows.Forms
程序集: System.Windows.Forms(在 System.Windows.Forms.dll 中)
异常 | 条件 |
---|---|
ObjectDisposedException |
此 WebBrowser 实例不再有效。 |
InvalidOperationException |
未能从基础 ActiveX WebBrowser 控件检索到对 IWebBrowser2 接口的实现的引用。 |
如果要通过 HTML 文档对象模型 (DOM) 访问显示在 WebBrowser 控件中的网页的内容,则使用此属性。 例如,如果要在 Windows 窗体应用程序中使用基于 Web 的控件,此属性十分有用。
可以将此属性与 ObjectForScripting 属性组合使用,以便在 WebBrowser 控件中显示的网页与应用程序之间实现双向通信。 使用 HtmlDocument.InvokeScript 方法从客户端应用程序代码调用网页中实现的脚本方法。 脚本代码可以通过 window.external 对象访问应用程序,该对象是用于主机访问的内置 DOM 对象,它映射到为 ObjectForScripting 属性指定的对象。
若要将网页的内容作为字符串访问,请使用 DocumentText 属性。 若要将网页的内容作为 Stream 访问,请使用 DocumentStream 属性。
下面的代码示例演示如何使用 Navigating 事件处理程序中的 Document 属性来确定网页表单是否已经填充。 如果输入字段不包含值,则取消导航。
此示例要求窗体包含一个名为 webBrowser1 的 WebBrowser 控件。
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()); } }
- SecurityPermission
用于要使用此控件的直接调用方。要求值:LinkDemand;命名的权限集:FullTrust。
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。