WebBrowser.DocumentText Egenskap

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs
Källa:
WebBrowser.cs

Hämtar eller anger HTML-innehållet på sidan som visas i WebBrowser kontrollen.

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

Egenskapsvärde

String

HTML-texten på den visade sidan eller den tomma strängen ("") om inget dokument läses in.

Attribut
BrowsableAttribute

Undantag

ObjectDisposedException

Den här WebBrowser instansen är inte längre giltig.

InvalidOperationException

Det gick inte att hämta en referens till en implementering av IWebBrowser2 gränssnittet från den underliggande ActiveX-kontrollen WebBrowser .

Exempel

Följande kodexempel visar hur du använder DocumentText egenskapen för att programmatiskt visa dokumentinnehåll som du väljer. Det här exemplet kräver att formuläret innehåller en WebBrowser kontroll med namnet 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

Kommentarer

Använd den här egenskapen när du vill ändra innehållet på en HTML-sida som visas i WebBrowser kontrollen med hjälp av strängbearbetningsverktyg. Du kan till exempel använda den här egenskapen för att läsa in sidor från en databas eller analysera sidor med reguljära uttryck. När du anger den WebBrowser här egenskapen navigerar kontrollen automatiskt till den om:tomma URL:en innan den angivna texten läses in. Det innebär att Navigatinghändelserna , Navigatedoch DocumentCompleted inträffar när du anger den här egenskapen och att värdet för Url egenskapen inte längre är meningsfullt.

Note

Den här egenskapen innehåller texten i det aktuella dokumentet, även om ett annat dokument har begärts. Om du anger värdet för den här egenskapen och sedan omedelbart hämtar den igen kan det hämtade värdet skilja sig från värdet som angetts om WebBrowser kontrollen inte har haft tid att läsa in det nya innehållet. Du kan hämta det nya värdet i en DocumentCompleted händelsehanterare. Du kan också blockera tråden tills dokumentet läses in genom att anropa Thread.Sleep metoden i en loop tills DocumentText egenskapen returnerar det värde som du ursprungligen angav den till.

Om du vill komma åt innehållet på en webbsida som en Streamanvänder du DocumentStream egenskapen . Du kan också komma åt sidinnehållet med hjälp av HTML-dokumentobjektmodellen (DOM) via Document egenskapen .

Gäller för

Se även