WebBrowser.DocumentTitle Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Titel des gegenwärtig im WebBrowser-Steuerelement angezeigten Dokuments ab.

public:
 property System::String ^ DocumentTitle { System::String ^ get(); };

[System.ComponentModel.Browsable(false)]
public string DocumentTitle { get; }

[<System.ComponentModel.Browsable(false)>]
member this.DocumentTitle : string

Public ReadOnly Property DocumentTitle As String

Eigenschaftswert

String

Der Titel des aktuellen Dokuments oder eine leere Zeichenfolge (""), wenn kein Dokument geladen wurde.

Attribute: BrowsableAttribute

Ausnahmen

ObjectDisposedException

Diese WebBrowser-Instanz ist nicht mehr gültig.

InvalidOperationException

Aus dem zugrunde liegenden ActiveX-IWebBrowser2-Steuerelement konnte kein Verweis auf eine Implementierung der WebBrowser-Schnittstelle abgerufen werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DocumentTitle -Eigenschaft verwendet wird, um die Formulartitelleiste mit dem Titel des aktuellen Dokuments zu aktualisieren. In diesem Beispiel muss das Formular ein WebBrowser -Steuerelement mit dem Namen webBrowser1enthalten.

Das vollständige Codebeispiel finden Sie unter Vorgehensweise: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung.

// Updates the title bar with the current document title.
void WebBrowser1_DocumentTitleChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->Text = WebBrowser1->DocumentTitle;
}

// Updates the title bar with the current document title.
private void webBrowser1_DocumentTitleChanged(object sender, EventArgs e)
{
    this.Text = webBrowser1.DocumentTitle;
}

' Updates the title bar with the current document title.
Private Sub webBrowser1_DocumentTitleChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles webBrowser1.DocumentTitleChanged

    Me.Text = webBrowser1.DocumentTitle

End Sub

Hinweise

Diese Eigenschaft ist beispielsweise nützlich, wenn Sie den Dokumenttitel in der Titelleiste der Anwendung anzeigen möchten. Wenn kein Titel für das aktuelle Dokument definiert wurde, wird diese Eigenschaft auf den Dokumentspeicherort und den Dateinamen festgelegt.

Behandeln Sie das DocumentTitleChanged Ereignis, um den Titel in der Titelleiste zu aktualisieren, wenn das WebBrowser Steuerelement zu einem neuen Dokument navigiert.

Gilt für: