JournalEntry Klasa

Definicja

Przestrzeń nazw:

System.Windows.Navigation

Zestaw:

PresentationFramework.dll

Reprezentuje wpis w historii nawigacji wstecz lub do przodu.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

JournalEntry

Atrybuty

SerializableAttribute

Implementuje

ISerializable

Przykłady

W poniższym przykładzie pokazano, jak pobrać najnowszy JournalEntry obiekt ze stosu nawigacji wstecznej, aby uzyskać Name wartości właściwości i Source .

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

Uwagi

Windows Presentation Foundation implementuje usługę historii nawigacji, która przechowuje jeden wpis dla każdego elementu zawartości, do której wcześniej przechodzino, podobnie jak historia nawigacji w programie Microsoft Internet Explorer. Historia nawigacji składa się z dwóch stosów, jeden, który zapamiętuje historię nawigacji wstecz, i historię nawigacji do przodu.

Wpis dla bieżącego elementu jest dodawany do historii nawigacji wstecznej po wystąpieniu nawigacji do przodu. Dzieje się tak w następujących sytuacjach:

• Metoda jest wywoływana Navigate (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Metoda jest wywoływana GoForward (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Przycisk przesyłania dalej w interfejsie użytkownika nawigacji wyświetlanym z bieżącego nawigatora (XBAP, NavigationWindow, Frame).

Podobnie wpis dla bieżącego elementu jest dodawany do historii nawigacji do przodu, zanim nastąpi nawigacja wstecz, co ma miejsce, gdy:

• Metoda jest wywoływana GoBack (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Przycisk Wstecz w interfejsie użytkownika nawigacji wyświetlanym z bieżącego nawigatora (XBAP, NavigationWindow, Frame).

Każdy wpis w historii nawigacji z powrotem i do przodu jest wystąpieniem JournalEntry klasy.

Każdy JournalEntry obiekt hermetyzuje informacje o określonej nawigacji, w tym nazwę wpisu (Name), czy wpis jest utrzymywany przy życiu (KeepAlive) i jednolity identyfikator zasobu (URI) dla zawartości, do którą przechodziSource ().

Wszystkie obiekty w historii nawigacji z powrotem można pobrać JournalEntry , wyliczając NavigationWindow.BackStack właściwości lub Frame.BackStack . W przypadku historii nawigacji do przodu można pobrać wszystkie JournalEntry obiekty, wyliczając NavigationWindow.ForwardStack właściwości lub Frame.ForwardStack .

Jeśli musisz usunąć najnowszy obiekt z historii nawigacji wstecznej JournalEntry , aby uniemożliwić jej nawigację, na przykład możesz wywołać RemoveBackEntry metodę (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), która usuwa JournalEntry obiekt i zwraca odwołanie do niego.

Nie można jednak dodawać JournalEntry obiektów do historii nawigacji, ponieważ nie można tworzyć ani tworzyć wystąpień ani pochodzić z JournalEntryelementu , a ponieważ żaden typ nie implementuje elementu członkowskiego do tego celu. Można jednak dodać obiekty niestandardowe CustomContentState do historii nawigacji, wywołując AddBackEntry metodę (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService dodaje CustomContentState obiekt do wewnętrznie utworzonego JournalEntry obiektu, który następnie jest dodawany do historii nawigacji wstecz.

Konstruktory

JournalEntry(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy JournalEntry.

Pola

KeepAliveProperty	Identyfikuje dołączoną KeepAlive właściwość.
NameProperty	Identyfikuje dołączoną Name właściwość.

Właściwości

CustomContentState	Pobiera lub ustawia CustomContentState obiekt skojarzony z tym wpisem dziennika.
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Name	Pobiera lub ustawia nazwę wpisu dziennika.
Source	Pobiera lub ustawia identyfikator URI zawartości, do którą został przekierowany.

Właściwości dołączone

KeepAlive

Pobiera lub ustawia wartość wskazującą, czy zawartość wpisu dziennika jest zachowywana lub tworzona ponownie podczas przechodzenia do historii nawigacji.

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetKeepAlive(DependencyObject)	Zwraca dołączoną KeepAlive właściwość wpisu dziennika dla określonego elementu.
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetName(DependencyObject)	Pobiera dołączoną Name właściwość wpisu dziennika dla określonego elementu.
GetObjectData(SerializationInfo, StreamingContext)	Wywoływane, gdy ten obiekt jest serializowany.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Ustawia dołączoną KeepAlive właściwość określonego elementu.
SetName(DependencyObject, String)	Ustawia dołączoną Name właściwość określonego elementu.
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)