WebBrowser.DocumentText プロパティ

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

WebBrowser コントロールに表示するページの HTML コンテンツを取得または設定します。

public:
 property System::String ^ DocumentText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string DocumentText { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DocumentText : string with get, set
Public Property DocumentText As String

プロパティ値

String

表示されるページの HTML テキスト。ドキュメントが読み込まれていない場合は、空の文字列 ("")。

属性
BrowsableAttribute

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

例

次のコード例では、 プロパティを使用して、選択した DocumentText ドキュメント コンテンツをプログラムで表示する方法を示します。 この例では、フォームに というコントロール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());
    }
}

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

注釈

文字列処理ツールを使用してコントロールに表示される HTML ページの内容を操作する場合は、このプロパティを WebBrowser 使用します。 たとえば、このプロパティを使用すると、データベースからページを読み込んだり、正規表現を使用してページを分析したりできます。 このプロパティを設定すると、指定したテキストを WebBrowser 読み込む前に、コントロールは about:blank URL に自動的に移動します。 これは、このプロパティを Navigating設定したときに、、 Navigatedおよび DocumentCompleted イベントが発生し、プロパティの Url 値が意味をなさなくなったことを意味します。

注意

このプロパティには、別のドキュメントが要求された場合でも、現在のドキュメントのテキストが含まれます。 このプロパティの値を設定し、すぐに再び取得する場合、コントロールに新しいコンテンツを読み込む時間がない場合、取得される値は設定された値とは異なる場合 WebBrowser があります。 イベント ハンドラーで新しい値を DocumentCompleted 取得できます。 または、 プロパティが最初に設定した値を返すまでループで メソッドを Thread.Sleep 呼び出して、ドキュメントが読み込まれるまで DocumentText スレッドをブロックすることもできます。

として Web ページ Streamの内容にアクセスするには、 プロパティを DocumentStream 使用します。 また、 プロパティを使用して HTML ドキュメント オブジェクト モデル (DOM) を使用してページの内容に Document アクセスすることもできます。

適用対象

こちらもご覧ください