Aracılığıyla paylaş

WebBrowser.Document Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Denetimde WebBrowser şu anda görüntülenen Web sayfasını temsil eden bir HtmlDocument alır.

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

Özellik Değeri

HtmlDocument

HtmlDocument Geçerli sayfayı temsil eden veya null hiçbir sayfa yüklenmediyse.

Öznitelikler
BrowsableAttribute

Özel durumlar

ObjectDisposedException

Bu WebBrowser örnek artık geçerli değil.

InvalidOperationException

Arabirimin bir uygulamasına IWebBrowser2 başvuru, temel alınan ActiveX WebBrowser denetiminden alınamadı.

Örnekler

Aşağıdaki kod örneği, bir Web sayfası formunun Document doldurulup doldurulmadığını belirlemek üzere olay işleyicisinde Navigating özelliğinin nasıl kullanılacağını gösterir. Giriş alanı bir değer içermiyorsa gezinti iptal edilir.

Bu örnek, formunuzun adlı webBrowser1bir WebBrowser denetim içermesi gerekir.

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

Açıklamalar

Denetimde WebBrowser görüntülenen bir Web sayfasının içeriğine HTML belgesi nesne modeli (DOM) aracılığıyla erişmek istediğinizde bu özelliği kullanın. Bu, örneğin Windows Forms uygulamanızda Web tabanlı denetimleri kullanmak istediğinizde kullanışlıdır.

Denetimde görüntülenen WebBrowser bir Web sayfası ile uygulamanız arasında iki yönlü iletişim uygulamak için bu özelliği özelliğiyle ObjectForScripting birlikte kullanabilirsiniz. HtmlDocument.InvokeScript İstemci uygulama kodunuzdan bir Web sayfasında uygulanan betik yöntemlerini çağırmak için yöntemini kullanın. Betik kodunuz, konak erişimi için sağlanan yerleşik bir DOM nesnesi olan ve özelliği için ObjectForScripting belirttiğiniz bir nesneyle eşlenen nesnesi aracılığıyla window.external uygulamanıza erişebilir.

Web sayfasının içeriğine dize olarak erişmek için özelliğini kullanın DocumentText . Bir Web sayfasının içeriğine olarak Streamerişmek için özelliğini kullanın DocumentStream .

Şunlara uygulanır

Ayrıca bkz.