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

[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 Zurücknavigationsstapel abrufen, um die Name Eigenschaftswerte 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 Microsoft Internet Explorer. Der Navigationsverlauf umfasst zwei Stapel, einen, der den Zurücknavigationsverlauf speichert, und einen, der den Vorwärtsnavigationsverlauf speichert.

Ein Eintrag für das aktuelle Element wird dem Verlauf der Zurücknavigation hinzugefügt, wenn eine Vorwärtsnavigation auftritt. Dies geschieht in den folgenden Situationen:

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

• Die GoForward -Methode wird aufgerufen (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 dem Vorwärtsnavigationsverlauf ein Eintrag für das aktuelle Element hinzugefügt, bevor eine Zurücknavigation erfolgt. Dies geschieht in folgenden Fällen:

• Die GoBack -Methode wird aufgerufen (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 Rückwärts- und Vorwärtsnavigationsverlauf 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 am Leben gehalten wird (KeepAlive) und der Uniform Resource Identifier (URI) für den Inhalt, der zu (Source) navigiert wird.

Sie können alle JournalEntry Objekte im Hintergrundnavigationsverlauf 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 z. B. die RemoveBackEntry -Methode (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry) aufrufen, die das JournalEntry Objekt entfernt und einen Verweis darauf zurückgibt.

Sie können dem Navigationsverlauf jedoch keine -Objekte hinzufügen JournalEntry , da Sie weder instanziieren noch von JournalEntryableiten können und kein Typ einen Member implementiert. Sie können jedoch benutzerdefinierte CustomContentState Objekte zum Zurücknavigationsverlauf hinzufügen, indem Sie die AddBackEntry -Methode (AddBackEntry, AddBackEntry, AddBackEntry) NavigationService aufrufen, das - CustomContentState Objekt einem intern erstellten JournalEntry -Objekt hinzufügt, das dann dem Zurücknavigationsverlauf 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 den ab, der DependencyObjectType den CLR-Typ dieser Instanz 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)