WebBrowser.Document 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 yang mewakili halaman Web yang HtmlDocument saat ini ditampilkan dalam WebBrowser kontrol.

public:
 property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument? Document { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Document : System.Windows.Forms.HtmlDocument

Public ReadOnly Property Document As HtmlDocument

Nilai Properti

HtmlDocument

Mewakili HtmlDocument halaman saat ini, atau null jika tidak ada halaman 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 Document properti dalam handler untuk peristiwa guna Navigating menentukan apakah formulir halaman Web telah diisi. Jika bidang input tidak berisi nilai, navigasi dibatalkan.

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 mengakses konten halaman Web yang ditampilkan dalam WebBrowser kontrol melalui model objek dokumen HTML (DOM). Ini berguna, misalnya, ketika Anda ingin menggunakan kontrol berbasis Web di aplikasi Windows Forms Anda.

Anda dapat menggunakan properti ini, dalam kombinasi dengan ObjectForScripting properti , untuk menerapkan komunikasi dua arah antara halaman Web yang ditampilkan dalam WebBrowser kontrol dan aplikasi Anda. HtmlDocument.InvokeScript Gunakan metode untuk memanggil metode skrip yang diterapkan di halaman Web dari kode aplikasi klien Anda. Kode skrip Anda dapat mengakses aplikasi Anda melalui window.external objek , yang merupakan objek DOM bawaan yang disediakan untuk akses host, dan mana yang memetakan ke objek yang Anda tentukan untuk ObjectForScripting properti .

Untuk mengakses konten halaman Web sebagai string, gunakan DocumentText properti . Untuk mengakses konten halaman Web sebagai Stream, gunakan DocumentStream properti .

Berlaku untuk

Bagikan melalui