JournalEntry Класс

Определение

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

Наследование

Object

DispatcherObject

DependencyObject

JournalEntry

Атрибуты

SerializableAttribute

Реализации

ISerializable

Примеры

В следующем примере показано, как получить последний JournalEntry объект из стека обратной навигации для получения значений Name свойств и 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

Комментарии

Windows Presentation Foundation реализует службу журнала навигации, которая хранит по одной записи для каждого фрагмента содержимого, к которому ранее был выполнен переход, как и в журнале навигации в браузере. Журнал навигации состоит из двух стеков: один из которых запоминает журнал навигации назад, а второй — журнал навигации вперед.

Запись для текущего элемента добавляется в журнал навигации назад, когда происходит прямая навигация. Это происходит в следующих ситуациях:

• Метод Navigate вызывается (NavigationService.Navigate, NavigationWindow.Navigate, ). Frame.Navigate

• Метод GoForward вызывается (NavigationService.GoForward, NavigationWindow.GoForward, ). Frame.GoForward

• Кнопка вперед в пользовательском интерфейсе навигации, отображаемая из текущего навигатора (XBAP, NavigationWindow, ). Frame

Аналогичным образом, запись для текущего элемента добавляется для пересылки журнала навигации перед переходом назад, что происходит в следующих случаях:

• Метод GoBack вызывается (NavigationService.GoBack, NavigationWindow.GoBack, ). Frame.GoBack

• Кнопка "Назад" в пользовательском интерфейсе навигации, отображаемая из текущего навигатора (XBAP, NavigationWindow, ). Frame

Каждая запись в журнале навигации "Назад" и "Вперед" является экземпляром JournalEntry класса .

Каждый JournalEntry объект инкапсулирует сведения о конкретной навигации, включая имя записи (Name), сохраняется ли запись в активном состоянии (KeepAlive) и универсальный идентификатор ресурса (URI) для содержимого, к которому осуществляется переход (Source).

Вы можете получить все объекты в журнале JournalEntry навигации с помощью перечисления NavigationWindow.BackStack свойств или Frame.BackStack . Для журнала навигации вперед можно получить все JournalEntry объекты, перечислив NavigationWindow.ForwardStack свойства или Frame.ForwardStack .

Если необходимо удалить последний JournalEntry объект из журнала навигации назад, например, чтобы предотвратить переход к нему, можно вызвать RemoveBackEntry метод (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), который удаляет JournalEntry объект и возвращает ссылку на него.

Однако нельзя добавлять JournalEntry объекты в журнал навигации, так как вы не можете ни создать экземпляр, ни производный от JournalEntry, а также поскольку ни один тип не реализует элемент для этого. Однако можно добавить пользовательские CustomContentState объекты в журнал навигации, вызвав AddBackEntry метод (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService добавляет CustomContentState объект в созданный JournalEntry внутри объекта, который затем добавляется в журнал навигации назад.

Конструкторы

Поля

Свойства

Присоединенные свойства

Методы

Применяется к