Udostępnij za pośrednictwem


JournalEntry Klasa

Definicja

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
Atrybuty
Implementuje

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:

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

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)

Dotyczy