WebBrowser.DocumentText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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, setPublic Property DocumentText As Stringプロパティ値
表示されるページの HTML テキスト。ドキュメントが読み込まれていない場合は、空の文字列 ("")。
- 属性
例外
この WebBrowser インスタンスは無効になっています。
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 スレッドをブロックすることもできます。
として StreamWeb ページの内容にアクセスするには、 プロパティを DocumentStream 使用します。 また、 プロパティを使用して HTML ドキュメント オブジェクト モデル (DOM) を使用してページの内容に Document アクセスすることもできます。
