WebBrowser.DocumentText Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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

String

Teks HTML dari halaman yang ditampilkan, atau string kosong ("") jika tidak ada dokumen yang dimuat.

Atribut: BrowsableAttribute

Pengecualian

ObjectDisposedException

Instans ini WebBrowser tidak lagi valid.

InvalidOperationException

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 .

Berlaku untuk

Bagikan melalui