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

未能从基础 ActiveX IWebBrowser2 控件检索到对 WebBrowser 接口的实现的引用。

示例

下面的代码示例演示如何使用 DocumentText 属性以编程方式显示所选的文档内容。 此示例要求窗体包含一 WebBrowser 个名为 的 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

注解

如果要使用字符串处理工具操作控件中显示的 HTML 页面的内容， WebBrowser 请使用此属性。 例如，可以使用此属性从数据库加载页面或使用正则表达式分析页面。 设置此属性时，控件会在 WebBrowser 加载指定文本之前自动导航到 about：blank URL。 这意味着 Navigating、 Navigated和 DocumentCompleted 事件在设置此属性时发生，并且 属性的值 Url 不再有意义。

注意

此属性包含当前文档的文本，即使已请求其他文档也是如此。 如果设置此属性的值，然后立即再次检索它，则如果 WebBrowser 控件没有时间加载新内容，则检索的值可能与设置的值不同。 可以在事件处理程序中 DocumentCompleted 检索新值。 或者，可以通过在循环中调用 Thread.Sleep 方法来阻止线程，直到该属性返回最初将其设置为的值，直到 DocumentText 文档加载。

若要以 的形式 Stream访问网页的内容，请使用 DocumentStream 属性。 还可以通过 Document 属性使用 HTML 文档对象模型 (DOM) 访问页面内容。

适用于

另请参阅