WebBrowser.DocumentText Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece el contenido HTML de la página que se muestra en el control 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 de propiedad

String

El texto HTLM de la página mostrada, o la cadena vacía ("") si no se carga ningún documento.

Atributos
BrowsableAttribute

Excepciones

ObjectDisposedException

Esta instancia de WebBrowser ya no es válida.

InvalidOperationException

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la DocumentText propiedad para mostrar mediante programación el contenido del documento que elija. En este ejemplo se requiere que el formulario contenga un WebBrowser control denominado 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

Comentarios

Utilice esta propiedad cuando desee manipular el contenido de una página HTML que se muestra en el WebBrowser control mediante herramientas de procesamiento de cadenas. Puede usar esta propiedad, por ejemplo, para cargar páginas de una base de datos o para analizar páginas mediante expresiones regulares. Al establecer esta propiedad, el WebBrowser control navega automáticamente a la dirección URL about:blank antes de cargar el texto especificado. Esto significa que los Navigatingeventos , Navigatedy DocumentCompleted se producen al establecer esta propiedad y el valor de la Url propiedad ya no es significativo.

Nota

Esta propiedad contiene el texto del documento actual, incluso si se ha solicitado otro documento. Si establece el valor de esta propiedad y, a continuación, lo recupera inmediatamente, el valor recuperado puede ser diferente del conjunto de valores si el WebBrowser control no ha tenido tiempo para cargar el nuevo contenido. Puede recuperar el nuevo valor en un DocumentCompleted controlador de eventos. Como alternativa, puede bloquear el subproceso hasta que se cargue el documento llamando al Thread.Sleep método en un bucle hasta que la DocumentText propiedad devuelva el valor en el que se estableció originalmente.

Para tener acceso al contenido de una página web como Stream, use la DocumentStream propiedad . También puede acceder al contenido de la página mediante el modelo de objetos de documento HTML (DOM) a través de la Document propiedad .

Se aplica a

Consulte también