WebBrowser.DocumentText Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o conteúdo HTML da página exibida no controle WebBrowser.

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

Valor da propriedade

String

O texto HTML da página exibida ou cadeia de caracteres vazia ("") se nenhum documento for carregado.

Atributos
BrowsableAttribute

Exceções

ObjectDisposedException

Essa instância WebBrowser não é mais válida.

InvalidOperationException

Uma referência a uma implementação da interface IWebBrowser2 não pôde ser recuperada do controle WebBrowser do ActiveX subjacente.

Exemplos

O exemplo de código a seguir demonstra como usar a propriedade para exibir programaticamente o DocumentText conteúdo do documento de sua escolha. Este exemplo requer que seu formulário contenha um WebBrowser controle chamado 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

Comentários

Use essa propriedade quando quiser manipular o conteúdo de uma página HTML exibida no WebBrowser controle usando ferramentas de processamento de cadeia de caracteres. Você pode usar essa propriedade, por exemplo, para carregar páginas de um banco de dados ou para analisar páginas usando expressões regulares. Quando você define essa propriedade, o WebBrowser controle navega automaticamente para a URL about:blank antes de carregar o texto especificado. Isso significa que os Navigatingeventos , Navigatede DocumentCompleted ocorrem quando você define essa propriedade e o valor da Url propriedade não é mais significativo.

Observação

Essa propriedade contém o texto do documento atual, mesmo que outro documento tenha sido solicitado. Se você definir o valor dessa propriedade e, em seguida, recuperá-la imediatamente novamente, o valor recuperado poderá ser diferente do valor definido se o WebBrowser controle não tiver tido tempo para carregar o novo conteúdo. Você pode recuperar o novo valor em um DocumentCompleted manipulador de eventos. Como alternativa, você pode bloquear o thread até que o documento seja carregado chamando o Thread.Sleep método em um loop até que a DocumentText propriedade retorne o valor para o qual você o definiu originalmente.

Para acessar o conteúdo de uma página da Web como um Stream, use a DocumentStream propriedade . Você também pode acessar o conteúdo da página usando o DOM (modelo de objeto de documento HTML) por meio da Document propriedade .

Aplica-se a

Confira também