JournalEntry Klasse

Definition

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Vererbung

Object

DispatcherObject

DependencyObject

JournalEntry

Attribute

SerializableAttribute

Implementiert

ISerializable

Beispiele

Das folgende Beispiel zeigt, wie Sie das neueste JournalEntry Objekt aus dem Backnavigationsstapel abrufen, um die Name Eigenschaftenwerte und Source 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.");
    }
}

Private Sub removeJournalEntryButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' If there are journal entries on the back navigation stack
    If Me.NavigationService.CanGoBack Then
        ' Remove and get the most recent entry on the back navigation stack
        Dim journalEntry As JournalEntry = Me.NavigationService.RemoveBackEntry()

        Dim name As String = journalEntry.Name
        Dim uri As String = journalEntry.Source.OriginalString
        MessageBox.Show(name & " [" & uri & "] removed from back navigation.")
    End If
End Sub

Hinweise

Windows Presentation Foundation implementiert einen Navigationsverlaufsdienst, der einen Eintrag für jeden Inhalt speichert, zu dem zuvor navigiert wurde, genau wie der Navigationsverlauf in einem Browser. Der Navigationsverlauf besteht aus zwei Stapeln, einer, der sich an den Zurücknavigationsverlauf erinnert, und einer, der sich an den Vorwärtsnavigationsverlauf erinnert.

Ein Eintrag für das aktuelle Element wird zum Backnavigationsverlauf hinzugefügt, wenn eine Vorwärtsnavigation erfolgt. Dies tritt in den folgenden Situationen auf:

• Die Navigate -Methode heißt (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Die GoForward -Methode heißt (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Die Vorwärtsschaltfläche auf der Navigationsoberfläche, die vom aktuellen Navigator (XBAP, NavigationWindow, Frame) angezeigt wird.

Ebenso wird ein Eintrag für das aktuelle Element hinzugefügt, um den Navigationsverlauf weiterzuleiten, bevor eine Zurücknavigation stattfindet. Dies geschieht in folgenden Fällen:

• Die GoBack -Methode heißt (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

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

Jeder Eintrag im Zurück- und Vorwärtsnavigationsverlauf ist ein instance der JournalEntry Klasse.

Jedes JournalEntry Objekt kapselt Informationen zu einer bestimmten Navigation, einschließlich eines Namens für den Eintrag (Name), der Angabe, ob der Eintrag am Leben bleibt (KeepAlive) und der Uniform Resource Identifier (URI) für den Inhalt, der zu (Source) navigiert wird.

Sie können alle JournalEntry Objekte im Backnavigationsverlauf abrufen, indem Sie die NavigationWindow.BackStack Eigenschaften oder Frame.BackStack auflisten. Für den JournalEntry Vorwärtsnavigationsverlauf können Sie alle Objekte abrufen, indem Sie die NavigationWindow.ForwardStack Eigenschaften oder Frame.ForwardStack auflisten.

Wenn Sie das neueste JournalEntry Objekt aus dem Hintergrundnavigationsverlauf entfernen müssen, können Sie beispielsweise die RemoveBackEntry -Methode (NavigationService.RemoveBackEntry, ) Frame.RemoveBackEntryaufrufen, NavigationWindow.RemoveBackEntrydie das JournalEntry Objekt entfernt und einen Verweis darauf zurückgibt.

Sie können jedoch keine Objekte zum Navigationsverlauf hinzufügen JournalEntry , da Sie weder instanziieren noch von ableiten JournalEntrykönnen, und weil kein Typ dazu einen Member implementiert. Sie können jedoch benutzerdefinierte CustomContentState Objekte zum Back-Navigationsverlauf hinzufügen, indem Sie die AddBackEntry -Methode aufrufen (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService fügt das CustomContentState Objekt einem intern erstellten JournalEntry Objekt hinzu, das dann dem Backnavigationsverlauf hinzugefügt wird.

Konstruktoren

Felder

Eigenschaften

Angefügte Eigenschaften

Methoden

Gilt für: