WebBrowser.DocumentText Property


WebBrowser コントロールに表示するページの HTML コンテンツを取得または設定します。 Gets or sets the HTML contents of the page displayed in the WebBrowser control.

public string DocumentText { get; set; }

表示されるページの HTML テキスト。ドキュメントが読み込まれていない場合は、空の文字列 ("")。 The HTML text of the displayed page, or the empty string ("") if no document 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.

次のコード例は、使用する方法を示します、DocumentTextプロパティをプログラムで独自のドキュメントのコンテンツを表示します。The following code example demonstrates how to use the DocumentText property to programmatically display document content of your choosing. この例では、フォームが含まれている必要があります、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>" +
    webBrowser1.Navigating += 
        new WebBrowserNavigatingEventHandler(webBrowser1_Navigating);

private void webBrowser1_Navigating(object sender, 
    WebBrowserNavigatingEventArgs e)
    System.Windows.Forms.HtmlDocument document =

    if (document != null && document.All["userName"] != null && 
        e.Cancel = true;
            "You must enter your name before you can navigate to " +
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>" & _

End Sub

Private Sub webBrowser1_Navigating( _
    ByVal sender As Object, ByVal e As WebBrowserNavigatingEventArgs) _
    Handles webBrowser1.Navigating

    Dim document As System.Windows.Forms.HtmlDocument = _
    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 " & _
    End If

End Sub


表示される HTML ページの内容を操作するときに、このプロパティを使用して、WebBrowser文字列処理ツールを使用して制御します。Use this property when you want to manipulate the contents of an HTML page displayed in the WebBrowser control using string processing tools. たとえば、このプロパティは、または正規表現を使用してページを分析するデータベースのページの読み込みに使用できます。You can use this property, for example, to load pages from a database or to analyze pages using regular expressions. このプロパティを設定するときに、WebBrowserにコントロールが自動的に移動します、について: 指定したテキストを読み込む前に URL を空白します。When you set this property, the WebBrowser control automatically navigates to the about:blank URL before loading the specified text. つまり、 NavigatingNavigated、およびDocumentCompletedこのプロパティは、しの値を設定すると、イベントが発生した、Urlプロパティは意味がなくなりました。This means that the Navigating, Navigated, and DocumentCompleted events occur when you set this property, and the value of the Url property is no longer meaningful.


このプロパティには、別のドキュメントが要求されている場合でも、現在のドキュメントのテキストが含まれています。This property contains the text of the current document, even if another document has been requested. このプロパティの値を設定し、すぐに再度取得する場合は、取得した値が場合は、設定値よりも異なる可能性があります、WebBrowser新しいコンテンツの読み込みに時間が制御されていません。If you set the value of this property and then immediately retrieve it again, the value retrieved may be different than the value set if the WebBrowser control has not had time to load the new content. 新しい値を取得することができます、DocumentCompletedイベント ハンドラー。You can retrieve the new value in a DocumentCompleted event handler. 呼び出すことによって、ドキュメントが読み込まれるまでスレッドをブロックする代わりに、Thread.Sleepまでループ内でメソッド、DocumentTextプロパティを設定する最初の値を返します。Alternatively, you can block the thread until the document is loaded by calling the Thread.Sleep method in a loop until the DocumentText property returns the value that you originally set it to.

として Web ページのコンテンツにアクセスする、Streamを使用して、DocumentStreamプロパティ。To access the contents of a Web page as a Stream, use the DocumentStream property. HTML ドキュメント オブジェクト モデル (DOM) を使用してページの内容からアクセスすることもできます、Documentプロパティ。You can also access the page contents using the HTML document object model (DOM) through the Document property.


このコントロールを使用する即時呼び出し元。 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.