WebBrowser.Document WebBrowser.Document WebBrowser.Document WebBrowser.Document Property

定義

現在 WebBrowser コントロールに表示されている Web ページを表す HtmlDocument を取得します。 Gets an HtmlDocument representing the Web page currently displayed in the WebBrowser control.

public:
 property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }
member this.Document : System.Windows.Forms.HtmlDocument
Public ReadOnly Property Document As HtmlDocument
プロパティ値

現在のページを表す HtmlDocument。ページが読み込まれていない場合は、null An HtmlDocument representing the current page, or null if no page is loaded.

例外

この WebBrowser インスタンスは無効になっています。 This WebBrowser instance is no longer valid.

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。 A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

次のコード例は、使用する方法を示します、Documentプロパティのハンドラーで、 Navigating Web ページのフォームをデータが格納されているかどうかを決定するイベントです。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.

この例では、フォームが含まれている必要があります、WebBrowserというコントロールwebBrowser1します。This example requires that your form contains a WebBrowser control called 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

注釈

表示される Web ページの内容にアクセスするときに、このプロパティを使用して、 WebBrowser HTML ドキュメント オブジェクト モデル (DOM) を制御します。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). これは、Windows フォーム アプリケーションで Web ベースのコントロールを使用する場合などに便利です。This is useful, for example, when you want to use Web-based controls in your Windows Forms application.

組み合わせてこのプロパティを使用して、ObjectForScriptingに表示される Web ページ間の双方向通信を実装するために、プロパティ、WebBrowserコントロールとアプリケーション。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. 使用して、HtmlDocument.InvokeScriptに、クライアント アプリケーション コードから Web ページに実装されているスクリプト メソッドを呼び出すメソッド。Use the HtmlDocument.InvokeScript method to call script methods implemented in a Web page from your client application code. スクリプト コードをアプリケーションにアクセスでき、window.externalホストのアクセス用の組み込み DOM オブジェクトであるし、指定したオブジェクトにマップする、オブジェクト、ObjectForScriptingプロパティ。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.

文字列として Web ページのコンテンツにアクセスするには、使用、DocumentTextプロパティ。To access the contents of a Web page as a string, use the DocumentText property. として Web ページのコンテンツにアクセスする、Streamを使用して、DocumentStreamプロパティ。To access the contents of a Web page as a Stream, use the DocumentStream property.

セキュリティ

SecurityPermission
このコントロールを使用する即時呼び出し元。 for immediate callers to use this control. 要求値: LinkDemand;[NIB: 名前付き権限セット](http://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3):FullTrustします。 Demand value: LinkDemand; [NIB: Named Permission Sets](http://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.

適用対象

こちらもご覧ください