WebBrowser.DocumentText Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le contenu HTML de la page affichée dans le contrôle 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

Valeur de propriété

String

Texte HTML de la page affichée, ou la chaîne vide ("") si aucun document n'est chargé.

Attributs: BrowsableAttribute

Exceptions

ObjectDisposedException

Cette instance de WebBrowser n'est plus valide.

InvalidOperationException

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.

Exemples

L’exemple de code suivant montre comment utiliser la propriété pour afficher par programmation le DocumentText contenu du document de votre choix. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé 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 manipuler le contenu d’une page HTML affichée dans le contrôle à l’aide d’outils de WebBrowser traitement de chaînes. Vous pouvez utiliser cette propriété, par exemple, pour charger des pages à partir d’une base de données ou pour analyser des pages à l’aide d’expressions régulières. Lorsque vous définissez cette propriété, le WebBrowser contrôle accède automatiquement à l’URL about:blank avant de charger le texte spécifié. Cela signifie que les Navigatingévénements , Navigatedet DocumentCompleted se produisent lorsque vous définissez cette propriété et que la valeur de la Url propriété n’est plus significative.

Notes

Cette propriété contient le texte du document actif, même si un autre document a été demandé. Si vous définissez la valeur de cette propriété, puis que vous la récupérez immédiatement, la valeur récupérée peut être différente de la valeur définie si le contrôle n’a pas eu le WebBrowser temps de charger le nouveau contenu. Vous pouvez récupérer la nouvelle valeur dans un gestionnaire d’événements DocumentCompleted . Vous pouvez également bloquer le thread jusqu’à ce que le document soit chargé en appelant la Thread.Sleep méthode dans une boucle jusqu’à ce que la DocumentText propriété retourne la valeur sur laquelle vous l’avez initialement définie.

Pour accéder au contenu d’une page web en tant que Stream, utilisez la DocumentStream propriété . Vous pouvez également accéder au contenu de la page à l’aide du modèle DOM (Document Object Model) HTML via la Document propriété .

S’applique à