WebBrowser.DocumentText Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur konten HTML halaman yang ditampilkan dalam WebBrowser kontrol.
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
Nilai Properti
Teks HTML dari halaman yang ditampilkan, atau string kosong ("") jika tidak ada dokumen yang dimuat.
- Atribut
Pengecualian
Instans ini WebBrowser tidak lagi valid.
Referensi ke implementasi IWebBrowser2
antarmuka tidak dapat diambil dari kontrol ActiveX WebBrowser
yang mendasar.
Contoh
Contoh kode berikut menunjukkan cara menggunakan DocumentText properti untuk menampilkan konten dokumen yang Anda pilih secara terprogram. Contoh ini mengharuskan formulir Anda berisi kontrol yang WebBrowser disebut 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
Keterangan
Gunakan properti ini saat Anda ingin memanipulasi konten halaman HTML yang ditampilkan dalam WebBrowser kontrol menggunakan alat pemrosesan string. Anda dapat menggunakan properti ini, misalnya, untuk memuat halaman dari database atau menganalisis halaman menggunakan ekspresi reguler. Saat Anda mengatur properti ini, WebBrowser kontrol secara otomatis menavigasi ke URL tentang:kosong sebelum memuat teks yang ditentukan. Ini berarti bahwa Navigatingperistiwa , Navigated, dan DocumentCompleted terjadi ketika Anda mengatur properti ini, dan nilai Url properti tidak lagi bermakna.
Catatan
Properti ini berisi teks dokumen saat ini, meskipun dokumen lain telah diminta. Jika Anda menetapkan nilai properti ini dan kemudian segera mengambilnya lagi, nilai yang diambil mungkin berbeda dari nilai yang ditetapkan jika WebBrowser kontrol belum sempat memuat konten baru. Anda dapat mengambil nilai baru dalam penanganan DocumentCompleted aktivitas. Atau, Anda dapat memblokir utas hingga dokumen dimuat dengan memanggil Thread.Sleep metode dalam perulangan hingga DocumentText properti mengembalikan nilai yang awalnya Anda atur.
Untuk mengakses konten halaman Web sebagai Stream, gunakan DocumentStream properti . Anda juga dapat mengakses konten halaman menggunakan model objek dokumen HTML (DOM) melalui Document properti .