WebBrowser.DocumentText Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

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

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 de Propriedade

String

O texto HTML da página apresentada, ou a cadeia vazia ("") se nenhum documento for carregado.

Atributos
BrowsableAttribute

Exceções

ObjectDisposedException

Esta WebBrowser situação já não é válida.

InvalidOperationException

Uma referência a uma implementação da IWebBrowser2 interface não podia ser recuperada a partir do controlo ActiveX WebBrowser subjacente.

Exemplos

O exemplo de código seguinte demonstra como usar a DocumentText propriedade para exibir programaticamente o conteúdo do documento à sua escolha. Este exemplo exige que a sua forma contenha um WebBrowser controlo 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

Observações

Use esta propriedade quando quiser manipular o conteúdo de uma página HTML exibido no WebBrowser controlo usando ferramentas de processamento de strings. Pode usar esta propriedade, por exemplo, para carregar páginas a partir de uma base de dados ou para analisar páginas usando expressões regulares. Quando defines esta propriedade, o WebBrowser controlo navega automaticamente até ao URL about:blank antes de carregar o texto especificado. Isto significa que os Navigating, , e DocumentCompleted os eventos ocorrem quando se define esta propriedade, e o valor da Url propriedade deixa Navigatedde ser significativo.

Note

Esta propriedade contém o texto do documento atual, mesmo que tenha sido solicitado outro documento. Se definir o valor desta propriedade e depois a recuperar imediatamente, o valor recuperado pode ser diferente do conjunto de valores se o WebBrowser controlo não tiver tido tempo de carregar o novo conteúdo. Podes recuperar o novo valor num DocumentCompleted gestor de eventos. Alternativamente, podes bloquear o thread até o documento ser carregado, chamando o Thread.Sleep método num loop até que a DocumentText propriedade devolva o valor que originalmente definiste.

Para aceder ao conteúdo de uma página Web como Stream, utilize a DocumentStream propriedade. Também pode aceder ao conteúdo da página usando o modelo de objetos do documento HTML (DOM) através da Document propriedade.

Aplica-se a

Ver também