WebBrowser::Document Property
Gets an HtmlDocument representing the Web page currently displayed in the WebBrowser control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: [BrowsableAttribute(false)] property HtmlDocument^ Document { HtmlDocument^ get(); }
Property Value
Type: System.Windows.Forms::HtmlDocument^An HtmlDocument representing the current page, or null if no page is loaded.
| Exception | Condition |
|---|---|
| ObjectDisposedException | This WebBrowser instance is no longer valid. |
| InvalidOperationException | A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control. |
Use this property when you want to access the contents of a Web page displayed in the WebBrowser control through the HTML document object model (DOM). This is useful, for example, when you want to use Web-based controls in your Windows Forms application.
You can use this property, in combination with the ObjectForScripting property, to implement two-way communication between a Web page displayed in the WebBrowser control and your application. Use the HtmlDocument::InvokeScript method to call script methods implemented in a Web page from your client application code. Your scripting code can access your application through the window.external object, which is a built-in DOM object provided for host access, and which maps to an object that you specify for the ObjectForScripting property.
To access the contents of a Web page as a string, use the DocumentText property. To access the contents of a Web page as a Stream, use the DocumentStream property.
The following code example demonstrates how to use the Document property in a handler for the Navigating event to determine whether a Web page form has been filled in. If the input field does not contain a value, the navigation is canceled.
This example requires that your form contains a WebBrowser control called webBrowser1.
for immediate callers to use this control. Demand value: LinkDemand; NIB: Named Permission Sets: FullTrust.
Available since 2.0