JournalEntry Klasse

Definition

Namespace:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Stellt einen Eintrag im Navigationsverlauf zurück oder im Navigationsverlauf vor dar.

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

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

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Vererbung

Object

DispatcherObject

DependencyObject

JournalEntry

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

JournalEntry(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der JournalEntry-Klasse.

Felder

KeepAliveProperty	Bezeichnet die angefügte KeepAlive-Eigenschaft.
NameProperty	Bezeichnet die angefügte Name-Eigenschaft.

Eigenschaften

CustomContentState	Ruft das CustomContentState-Objekt ab, das diesem Journaleintrag zugeordnet ist, oder legt dieses fest.
DependencyObjectType	Ruft die ab, die DependencyObjectType den CLR-Typ dieser instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
Name	Ruft den Namen des Journaleintrags ab oder legt diesen fest.
Source	Ruft den URI des Inhalts ab, zu dem navigiert wurde, oder legt diesen fest.

Angefügte Eigenschaften

KeepAlive

Ruft einen Wert ab, der angibt, ob der Inhalt eines Journaleintrags beibehalten oder neu erstellt werden soll, wenn im Navigationsverlauf zu diesem Inhalt navigiert wird, oder legt diesen Wert fest.

Methoden

CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetKeepAlive(DependencyObject)	Gibt den Wert der angefügten KeepAlive-Eigenschaft des Journaleintrags für das angegebene Element zurück.
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetName(DependencyObject)	Ruft den Wert der angefügten Name-Eigenschaft des Journaleintrags für das angegebene Element ab.
GetObjectData(SerializationInfo, StreamingContext)	Wird aufgerufen, wenn dieses Objekt serialisiert wird.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Legt die angefügte KeepAlive-Eigenschaft des angegebenen Elements fest.
SetName(DependencyObject, String)	Legt die angefügte Name-Eigenschaft des angegebenen Elements fest.
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)