JournalEntry-Klasse

Windows Presentation Foundation (WPF) implementiert einen Navigationsverlaufdienst, der ebenso wie der Navigationsverlauf in Microsoft Internet Explorer einen Eintrag für jedes Inhaltselement speichert, zu dem zuvor navigiert wurde. Der Navigationsverlauf umfasst zwei Stapel. Ein Stapel speichert den Navigationsverlauf zurück, und der andere Stapel speichert den Navigationsverlauf vor.

Dem Navigationsverlauf zurück wird ein Eintrag für das aktuelle Element hinzugefügt, wenn eine Vorwärtsnavigation erfolgt. Dies tritt in den folgenden Situationen ein:

• Die Navigate-Methode wird aufgerufen (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Die GoForward-Methode wird aufgerufen (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Die Schaltfläche Vorwärts der Navigations-Benutzeroberfläche geklickt, die vom aktuellen Navigator angezeigt wird (XBAP, NavigationWindow, Frame).

Ebenso wird dem Navigationsverlauf vor ein Eintrag für das aktuelle Element hinzugefügt, bevor eine Navigation zurück erfolgt. Dies ist in folgenden Situationen der Fall:

• Die GoBack-Methode wird aufgerufen (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Die Schaltfläche Zurück der Navigations-Benutzeroberfläche, die vom aktuellen Navigator angezeigt wird (XBAP, NavigationWindow, Frame).

Jeder Eintrag im Navigationsverlauf zurück und vor ist eine Instanz der JournalEntry-Klasse.

Jedes JournalEntry-Objekt kapselt Informationen zu einer bestimmten Navigation, einschließlich eines Namens für den Eintrag (Name), ob der Eintrag beibehalten wird (KeepAlive) sowie des Uniform Resource Identifier (URI) für den Inhalt, zu dem navigiert wird (Source).

Sie können alle JournalEntry-Objekte im Navigationsverlauf zurück abrufen, indem Sie die NavigationWindow.BackStack-Eigenschaft oder die Frame.BackStack-Eigenschaft auflisten. Im Navigationsverlauf vor können Sie alle JournalEntry-Objekte abrufen, indem Sie die NavigationWindow.ForwardStack-Eigenschaft oder die Frame.ForwardStack-Eigenschaft auflisten.

Wenn Sie das neueste JournalEntry-Objekt aus dem Navigationsverlauf zurück entfernen müssen, um beispielsweise die Navigation zu diesem Objekt zu verhindern, können Sie die RemoveBackEntry-Methode aufrufen (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), die das JournalEntry-Objekt entfernt und einen Verweis auf dieses zurückgibt.

Dem Navigationsverlauf können jedoch keine JournalEntry-Objekte hinzugefügt werden., da weder das Instanziieren noch das Ableiten von JournalEntry möglich ist und da kein Typ einen Member für diese Aktionen implementiert. Sie können dem Navigationsverlauf zurück jedoch benutzerdefinierte CustomContentState-Objekte hinzufügen, indem Sie die AddBackEntry-Methode aufrufen (AddBackEntry, AddBackEntry, AddBackEntry). NavigationService fügt das CustomContentState-Objekt einem intern erstellten JournalEntry-Objekt hinzu, das anschließend dem Navigationsverlauf zurück hinzugefügt wird.

Im folgenden Beispiel wird veranschaulicht, wie das neueste JournalEntry-Objekt aus dem Navigationsstapel zurück abgerufen wird, um den Name-Eigenschaftswert und den Source-Eigenschaftswert abzurufen.

void removeJournalEntryButton_Click(object sender, RoutedEventArgs e)
{
    // If there are journal entries on the back navigation stack
    if (this.NavigationService.CanGoBack)
    {
        // Remove and get the most recent entry on the back navigation stack
        JournalEntry journalEntry = this.NavigationService.RemoveBackEntry();

        string name = journalEntry.Name;
        string uri = journalEntry.Source.OriginalString;
        MessageBox.Show(name + " [" + uri + "] removed from back navigation.");
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz