WebBrowser.Document Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene un oggetto HtmlDocument che rappresenta la pagina Web attualmente visualizzata nel controllo WebBrowser.

public:
 property System::Windows::Forms::HtmlDocument ^ Document { System::Windows::Forms::HtmlDocument ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument Document { get; }

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.HtmlDocument? Document { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Document : System.Windows.Forms.HtmlDocument

Public ReadOnly Property Document As HtmlDocument

Valore della proprietà

HtmlDocument

Oggetto HtmlDocument che rappresenta la pagina corrente oppure null se non viene caricata alcuna pagina.

Attributi: BrowsableAttribute

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la Document proprietà in un gestore per l'evento Navigating per determinare se un modulo di pagina Web è stato compilato. Se il campo di input non contiene un valore, la navigazione viene annullata.

In questo esempio è necessario che il modulo contenga un WebBrowser controllo denominato 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

Commenti

Utilizzare questa proprietà quando si desidera accedere al contenuto di una pagina Web visualizzata nel controllo tramite il WebBrowser modello DOM (Document Object Model) HTML. Ciò è utile, ad esempio, quando si vogliono usare controlli basati sul Web nell'applicazione Windows Forms.

È possibile utilizzare questa proprietà, in combinazione con la ObjectForScripting proprietà , per implementare la comunicazione bidirezionale tra una pagina Web visualizzata nel controllo e l'applicazione WebBrowser . Usare il metodo per chiamare i HtmlDocument.InvokeScript metodi di script implementati in una pagina Web dal codice dell'applicazione client. Il codice di scripting può accedere all'applicazione tramite l'oggetto window.external , ovvero un oggetto DOM predefinito fornito per l'accesso all'host e che esegue il mapping a un oggetto specificato per la ObjectForScripting proprietà .

Per accedere al contenuto di una pagina Web come stringa, utilizzare la DocumentText proprietà . Per accedere al contenuto di una pagina Web come , Streamutilizzare la DocumentStream proprietà .

Si applica a