JournalEntry Класс

Определение

Представляет запись в журнале переходов вперед или назад.Represents an entry in either back or forward navigation history.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable
Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable
Наследование
Атрибуты
Реализации

Примеры

В следующем примере показано, как получить самый последний объект JournalEntry из стека навигации назад, чтобы получить значения свойств Name и Source.The following example shows how to retrieve the most recent JournalEntry object from the back navigation stack to get the Name and Source property values.

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 реализует службу журнала навигации, в которой хранится одна запись для каждого фрагмента содержимого, к которому ранее был выполнен переход, так же, как журнал переходов в Microsoft Internet ExplorerMicrosoft Internet Explorer.Windows Presentation Foundation implements a navigation history service that stores one entry for each piece of content that has been previously navigated to, just like navigation history in Microsoft Internet ExplorerMicrosoft Internet Explorer. Журнал переходов состоит из двух стеков, один из которых запоминает журнал переходов, и один, который запоминает журнал переходов вперед.Navigation history comprises two stacks, one that remembers back navigation history, and one that remembers forward navigation history.

Запись для текущего элемента добавляется в журнал переходов назад при переходе вперед.An entry for the current item is added to back navigation history when a forward navigation occurs. Это происходит в следующих ситуациях.This occurs in the following situations:

Аналогичным образом запись для текущего элемента добавляется в журнал переходов вперед, прежде чем происходит переход назад, что происходит в следующих случаях:Likewise, an entry for the current item is added to forward navigation history before a back navigation occurs, which happens when:

Каждая запись в журнале переходов назад и вперед является экземпляром класса JournalEntry.Each entry in back and forward navigation history is an instance of the JournalEntry class.

Каждый объект JournalEntry инкапсулирует сведения о конкретной навигации, включая имя записи (Name), независимо от того, хранится ли запись в активном виде (KeepAlive) и является универсальным кодом ресурса (URI) для содержимого, к которому осуществляется переход (Source).Each JournalEntry object encapsulates information about a particular navigation, including a name for the entry (Name), whether the entry is kept alive (KeepAlive) and the uniform resource identifier (URI) for the content that is navigated to (Source).

Вы можете получить все JournalEntry объекты в журнале переходов назад, перечисляя свойства NavigationWindow.BackStack или Frame.BackStack.You can retrieve all the JournalEntry objects in back navigation history by enumerating the NavigationWindow.BackStack or Frame.BackStack properties. Для журнала переходов вперед можно получить все объекты JournalEntry, перечисляя свойства NavigationWindow.ForwardStack или Frame.ForwardStack.For forward navigation history, you can retrieve all the JournalEntry objects by enumerating the NavigationWindow.ForwardStack or Frame.ForwardStack properties.

Если необходимо удалить самый последний объект JournalEntry из журнала обратной навигации, чтобы предотвратить переход к нему, можно вызвать метод RemoveBackEntry (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), который удаляет объект JournalEntry и возвращает ссылку на него.If you need to remove the most recent JournalEntry object from back navigation history, to prevent navigation to it, for example, you can call the RemoveBackEntry method (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), which removes the JournalEntry object and returns a reference to it.

Однако нельзя добавлять объекты JournalEntry в журнал переходов, так как ни один из них не может быть производным от JournalEntry, и потому что ни один из типов не реализует для этого элемент.You cannot add JournalEntry objects to navigation history, however, because you can neither instantiate nor derive from JournalEntry, and because no type implements a member to do so. Однако можно добавить пользовательские объекты CustomContentState в журнал обратной навигации, вызвав метод AddBackEntry (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService добавляет объект CustomContentState во внутренний объект JournalEntry, который затем добавляется в журнал переходов назад.However, you can add custom CustomContentState objects to back navigation history by calling the AddBackEntry method (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService adds the CustomContentState object to an internally-created JournalEntry object, which is then added to the back navigation history.

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

JournalEntry(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса JournalEntry.Initializes a new instance of the JournalEntry class.

Поля

KeepAliveProperty

Идентифицирует присоединенное свойство KeepAlive.Identifies the KeepAlive attached property.

NameProperty

Идентифицирует присоединенное свойство Name.Identifies the Name attached property.

Свойства

CustomContentState

Возвращает или задает объект CustomContentState, связанный с данной записью журнала.Gets or sets the CustomContentState object that is associated with this journal entry.

DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Унаследовано от DependencyObject)
Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject)
Name

Возвращает или задает имя записи журнала.Gets or sets the name of the journal entry.

Source

Возвращает или задает URI содержимого, к которому был осуществлен переход.Gets or sets the URI of the content that was navigated to.

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

KeepAlive

Возвращает или задает значение, указывающее, сохраняется ли содержимое записи журнала в памяти или повторно создается при переходе к нему с использованием журнала.Gets or sets a value that indicates whether the content of a journal entry is either retained or re-created when navigated to in navigation history.

Методы

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject)
Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetKeepAlive(DependencyObject)

Возвращает присоединенное свойство KeepAlive записи журнала для указанного элемента.Returns the KeepAlive attached property of the journal entry for the specified element.

GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject)
GetName(DependencyObject)

Возвращает присоединенное свойство Name записи журнала для указанного элемента.Gets the Name attached property of the journal entry for the specified element.

GetObjectData(SerializationInfo, StreamingContext)

Вызывается при сериализации этого объекта.Called when this object is serialized.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей.Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное измененное свойство зависимостей сообщается в данных события.The specific dependency property that changed is reported in the event data.

(Унаследовано от DependencyObject)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject)
SetKeepAlive(DependencyObject, Boolean)

Задает значение присоединенного свойства KeepAlive в указанном элементе.Sets the KeepAlive attached property of the specified element.

SetName(DependencyObject, String)

Задает значение присоединенного свойства Name в указанном элементе.Sets the Name attached property of the specified element.

SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)

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