WebBrowser.Document Propiedad

Definición

Obtiene un HtmlDocument que representa la página Web que se muestra actualmente en el control WebBrowser.Gets an HtmlDocument representing the Web page currently displayed in the WebBrowser control.

public:
 property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }
member this.Document : System.Windows.Forms.HtmlDocument
Public ReadOnly Property Document As HtmlDocument

Valor de propiedad

HtmlDocument que representa la página actual o null si no se carga ninguna página.An HtmlDocument representing the current page, or null if no page is loaded.

Atributos

Excepciones

Esta instancia de WebBrowser ya no es válida.This WebBrowser instance is no longer valid.

Una referencia a una implementación de la interfaz IWebBrowser2 no se pudo recuperar del control ActiveX WebBrowser subyacente.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad Document en un controlador para el evento Navigating con el fin de determinar si se ha rellenado un formulario de página web.The following code example demonstrates how to use the Document property in a handler for the Navigating event to determine whether a Web page form has been filled in. Si el campo de entrada no contiene un valor, se cancela la navegación.If the input field does not contain a value, the navigation is canceled.

Este ejemplo requiere que el formulario contenga un control WebBrowser denominado webBrowser1.This example requires that your form contains a WebBrowser control called 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 si desea tener acceso al contenido de una página web que se muestra en el control WebBrowser a través del modelo de objetos de documento (DOM) HTML.Use this property when you want to access the contents of a Web page displayed in the WebBrowser control through the HTML document object model (DOM). Esto resulta útil, por ejemplo, cuando desea usar controles basados en Web en la aplicación Windows Forms.This is useful, for example, when you want to use Web-based controls in your Windows Forms application.

Puede usar esta propiedad, junto con la propiedad ObjectForScripting, para implementar la comunicación bidireccional entre una página web que se muestra en el control WebBrowser y la aplicación.You can use this property, in combination with the ObjectForScripting property, to implement two-way communication between a Web page displayed in the WebBrowser control and your application. Use el método HtmlDocument.InvokeScript para llamar a métodos de script implementados en una página web desde el código de la aplicación cliente.Use the HtmlDocument.InvokeScript method to call script methods implemented in a Web page from your client application code. El código de scripting puede tener acceso a la aplicación a través del objeto window.external, que es un objeto DOM integrado proporcionado para el acceso al host y que se asigna a un objeto que se especifica para la propiedad ObjectForScripting.Your scripting code can access your application through the window.external object, which is a built-in DOM object provided for host access, and which maps to an object that you specify for the ObjectForScripting property.

Para tener acceso al contenido de una página web como una cadena, utilice la propiedad DocumentText.To access the contents of a Web page as a string, use the DocumentText property. Para tener acceso al contenido de una página web como un Stream, utilice la propiedad DocumentStream.To access the contents of a Web page as a Stream, use the DocumentStream property.

Seguridad

SecurityPermission
para que los llamadores inmediatos utilicen este control.for immediate callers to use this control. Valor de petición: LinkDemand; Conjuntos de permisos con nombre: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Se aplica a

Consulte también: