WebBrowser.DocumentText Propriété

Définition

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é

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

Attributs

Exceptions

Cette instance de WebBrowser n'est plus valide.

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 DocumentText propriété pour afficher par programmation le 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 WebBrowser d’outils de 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 récupérez-la immédiatement, la valeur récupérée peut être différente de la valeur définie si le WebBrowser contrôle n’a pas eu le 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 dom (Document Object Model) HTML via la Document propriété .

S’applique à

Voir aussi