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

Définition

Obtient un HtmlDocument représentant la page Web affiché actuellement dans le contrôle 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

Valeur de propriété

HtmlDocument représentant la page active, ou null si aucune page n'est chargée.An HtmlDocument representing the current page, or null if no page is loaded.

Exceptions

Cette instance de WebBrowser n'est plus valide.This WebBrowser instance is no longer valid.

Une référence à une implémentation de l'interface IWebBrowser2 n'a pas pu être récupérée du contrôle WebBrowser ActiveX sous-jacent.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Exemples

L’exemple de code suivant montre comment utiliser la Document propriété dans un gestionnaire pour l' Navigating événement afin de déterminer si un formulaire de page Web a été rempli.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 le champ d’entrée ne contient pas de valeur, la navigation est annulée.If the input field does not contain a value, the navigation is canceled.

Dans cet exemple, votre formulaire doit contenir WebBrowser un contrôle webBrowser1appelé.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

Remarques

Utilisez cette propriété lorsque vous souhaitez accéder au contenu d’une page Web affichée dans le WebBrowser contrôle via le modèle DOM (Document Object Model) 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). Cela est utile, par exemple, lorsque vous souhaitez utiliser des contrôles Web dans votre application Windows Forms.This is useful, for example, when you want to use Web-based controls in your Windows Forms application.

Vous pouvez utiliser cette propriété, en association avec la ObjectForScripting propriété, pour implémenter la communication bidirectionnelle entre une page Web affichée WebBrowser dans le contrôle et votre application.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. Utilisez la HtmlDocument.InvokeScript méthode pour appeler des méthodes de script implémentées dans une page Web à partir de votre code d’application cliente.Use the HtmlDocument.InvokeScript method to call script methods implemented in a Web page from your client application code. Votre code de script peut accéder à votre application via window.external l’objet, qui est un objet DOM intégré fourni pour l’accès hôte et qui correspond à un objet que vous spécifiez pour la ObjectForScripting propriété.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.

Pour accéder au contenu d’une page Web sous forme de chaîne, utilisez DocumentText la propriété.To access the contents of a Web page as a string, use the DocumentText property. Pour accéder au contenu d’une page Web en tant Streamque, utilisez DocumentStream la propriété.To access the contents of a Web page as a Stream, use the DocumentStream property.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

S’applique à

Voir aussi