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

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

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Dziedziczenie

Object

DispatcherObject

DependencyObject

JournalEntry

Implementuje

ISerializable

Przykłady

W poniższym przykładzie pokazano, jak pobrać najnowszy JournalEntry obiekt ze stosu nawigacji wstecznej w celu pobrania 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 przeglądarce. Historia nawigacji składa się z dwóch stosów, jeden, który zapamiętuje historię nawigacji wstecz, i jeden, który zapamiętuje historię nawigacji do przodu.

Wpis dla bieżącego elementu jest dodawany do historii nawigacji wstecz 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 do przodu 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 powrót nawigacji, 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 wstecz 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, doSource którego przechodzi ().

Wszystkie obiekty można pobrać JournalEntry z powrotem w historii nawigacji, 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 JournalEntry obiekt z historii nawigacji wstecz, 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 , ani dlatego, że żaden typ nie implementuje elementu członkowskiego w tym celu. Można jednak dodać obiekty niestandardowe CustomContentState do historii nawigacji, wywołując AddBackEntry metodę (AddBackEntry, AddBackEntry), AddBackEntrydodając NavigationServiceCustomContentState obiekt do wewnętrznie utworzonego JournalEntry obiektu, który jest następnie 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	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (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órego została nawigowana.

Właściwości dołączone

KeepAlive

Pobiera lub ustawia wartość wskazującą, czy zawartość wpisu dziennika jest zachowywana, czy tworzona ponownie podczas przechodzenia do w 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 element DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca 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 DependencyObjectpliku . (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 dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetName(DependencyObject)	Pobiera dołączoną Name właściwość wpisu dziennika dla określonego elementu.
GetObjectData(SerializationInfo, StreamingContext)	Wywoływana, gdy ten obiekt jest serializowany.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy 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 zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która została zmieniona, 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 zmieniania jej ź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 jej 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ślonej 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ść dla 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)