WebBrowser.Document WebBrowser.Document WebBrowser.Document WebBrowser.Document Property

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 está cargada ninguna página.An HtmlDocument representing the current page, or null if no page is loaded.

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 usar el Document propiedad en un controlador para el Navigating evento para determinar si se ha rellenado el formulario de una 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 WebBrowser control 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 cuando desea tener acceso al contenido de una página Web que se muestra en el WebBrowser control mediante el 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 es útil, por ejemplo, si desea utilizar controles basados en Web en su aplicación de Windows Forms.This is useful, for example, when you want to use Web-based controls in your Windows Forms application.

Puede usar esta propiedad, en combinación con la ObjectForScripting propiedad, al implementar la comunicación bidireccional entre una página Web que se muestra en el WebBrowser control 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 HtmlDocument.InvokeScript método para llamar a métodos de script implementados en una página Web desde el código de 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 de la window.external objeto, que es un objeto DOM integrado proporcionado para el acceso de host, y que se asigna a un objeto que se especifique para el ObjectForScripting propiedad.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 obtener acceso al contenido de una página Web como una cadena, utilice el DocumentText propiedad.To access the contents of a Web page as a string, use the DocumentText property. Para obtener acceso al contenido de una página Web como un Stream, utilice el DocumentStream propiedad.To access the contents of a Web page as a Stream, use the DocumentStream property.

Seguridad

SecurityPermission
para que los llamadores inmediatos puede usar este control.for immediate callers to use this control. Valor de petición: LinkDemand; [NIB: Conjuntos de permisos con nombre](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.Demand value: LinkDemand; [NIB: Named Permission Sets](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.

Se aplica a

Consulte también: