Partager via

WebBrowser.DocumentText Propriété

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
WebBrowser.cs
Source:
WebBrowser.cs
Source:
WebBrowser.cs
Source:
WebBrowser.cs
Source:
WebBrowser.cs

Obtient ou définit le contenu HTML de la page affichée dans le WebBrowser contrôle.

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 chaîne vide («  ») si aucun document n’est chargé.

Attributs
BrowsableAttribute

Exceptions

ObjectDisposedException

Cette WebBrowser instance n’est plus valide.

InvalidOperationException

Impossible de récupérer une référence à une implémentation de l’interface IWebBrowser2 à partir du contrôle ActiveX WebBrowser sous-jacent.

Exemples

L’exemple de code suivant montre comment utiliser la propriété pour afficher par programme 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 WebBrowser d’outils de traitement de chaîne. 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 événements et NavigatedDocumentCompleted les Navigatingévénements se produisent lorsque vous définissez cette propriété et que la valeur de la Url propriété n’est plus significative.

Note

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 celle 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 à laquelle vous l’avez définie à l’origine.

Pour accéder au contenu d’une page Web en tant que Streampropriété, 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 à

Voir aussi