WebBrowser.DocumentText Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja a vezérlőelemben WebBrowser megjelenített oldal HTML-tartalmát.
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 StringTulajdonság értéke
A megjelenített oldal HTML-szövege vagy az üres sztring (""), ha nincs betöltve dokumentum.
- Attribútumok
Kivételek
Ez WebBrowser a példány már nem érvényes.
Az interfész implementációjára IWebBrowser2 mutató hivatkozás nem kérhető le az alapul szolgáló ActiveX-vezérlőből WebBrowser .
Példák
Az alábbi példakód bemutatja, hogyan használhatja a tulajdonságot a DocumentText választott dokumentumtartalom programozott megjelenítésére. Ez a példa megköveteli, hogy az űrlap tartalmaz egy úgynevezett vezérlőt WebBrowserwebBrowser1.
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
Megjegyzések
Ezt a tulajdonságot akkor használja, ha sztringfeldolgozó eszközökkel szeretné módosítani a WebBrowser vezérlőben megjelenő HTML-lap tartalmát. Ezt a tulajdonságot használhatja például oldalak adatbázisból való betöltésére vagy lapok normál kifejezések használatával történő elemzésére. A tulajdonság beállításakor a WebBrowser vezérlő automatikusan a about:blank URL-címre lép a megadott szöveg betöltése előtt. Ez azt jelenti, hogy a Navigating, , Navigatedés DocumentCompleted események a tulajdonság beállításakor fordulnak elő, és a Url tulajdonság értéke már nem értelmezhető.
Note
Ez a tulajdonság az aktuális dokumentum szövegét tartalmazza, még akkor is, ha egy másik dokumentumot kértek. Ha beállítja ennek a tulajdonságnak az értékét, majd azonnal újra lekéri, a beolvasott érték eltérhet a beállított értékétől, ha a WebBrowser vezérlőelemnek nincs ideje betölteni az új tartalmat. Az új értéket lekérheti egy DocumentCompleted eseménykezelőben. Azt is megteheti, hogy letiltja a szálat, amíg a dokumentum be nem töltődik. Ehhez hívja meg a Thread.Sleep metódust egy hurokban, amíg a DocumentText tulajdonság vissza nem adja az eredetileg beállított értéket.
Ha egy weblap tartalmát szeretné elérni, használja a tulajdonságotStreamDocumentStream. A tulajdonságon keresztül a HTML-dokumentumobjektum-modell (DOM) használatával is elérheti a Document lap tartalmát.
