Aracılığıyla paylaş

WebBrowser.DocumentText Özellik

  • Başvuru

Tanım

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

Denetimde görüntülenen WebBrowser sayfanın HTML içeriğini alır veya ayarlar.

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

Özellik Değeri

String

Görüntülenen sayfanın HTML metni veya hiçbir belge yüklenmemişse boş dize ("").

Ö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, seçtiğiniz belge içeriğini program aracılığıyla görüntülemek için özelliğinin nasıl kullanılacağını DocumentText gösterir. 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

Dize işleme araçlarını kullanarak denetimde WebBrowser görüntülenen bir HTML sayfasının içeriğini işlemek istediğinizde bu özelliği kullanın. Bu özelliği, örneğin, bir veritabanından sayfa yüklemek veya normal ifadeleri kullanarak sayfaları analiz etmek için kullanabilirsiniz. Bu özelliği ayarladığınızda WebBrowser , denetim belirtilen metni yüklemeden önce otomatik olarak about:blank URL'sine gider. Bu, , ve olaylarının Navigatingbu özelliği ayarladığınızda gerçekleştiği ve özelliğin değerinin Url artık anlamlı olmadığı anlamına DocumentCompleted gelir. Navigated

Not

Bu özellik, başka bir belge istenmiş olsa bile geçerli belgenin metnini içerir. Bu özelliğin değerini ayarlayıp hemen yeniden alırsanız, denetimin yeni içeriği yüklemek için zamanı yoksa WebBrowser alınan değer ayarlanan değerden farklı olabilir. Yeni değeri bir DocumentCompleted olay işleyicisinde alabilirsiniz. Alternatif olarak, özellik başlangıçta ayarladığınız değeri döndürene kadar yöntemini döngüde çağırarak Thread.Sleep belge yüklenene kadar DocumentText iş parçacığını engelleyebilirsiniz.

Bir Web sayfasının içeriğine olarak Streamerişmek için özelliğini kullanın DocumentStream . Sayfa içeriğine html belge nesne modelini (DOM) özelliği aracılığıyla Document da erişebilirsiniz.

Şunlara uygulanır

Ayrıca bkz.