本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

JournalEntry 类

 

表示后或向前导航历史记录中的项。

命名空间:   System.Windows.Navigation
程序集:  PresentationFramework(位于 PresentationFramework.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Navigation.JournalEntry

[SerializableAttribute]
public class JournalEntry : DependencyObject, ISerializable

名称说明
System_CAPS_protmethodJournalEntry(SerializationInfo, StreamingContext)

此 API 支持 产品 基础结构,不应从代码直接使用。 初始化 JournalEntry 类的新实例。

名称说明
System_CAPS_pubpropertyCustomContentState

获取或设置 CustomContentState 与此日志条目相关联的对象。

System_CAPS_pubpropertyDependencyObjectType

获取 DependencyObjectType 包装 CLR 此实例的类型。 (继承自 DependencyObject。)

System_CAPS_pubpropertyDispatcher

获取 DispatcherDispatcherObject 与相关联。(继承自 DispatcherObject。)

System_CAPS_pubpropertyIsSealed

获取一个指示此实例当前是否已密封 (只读)的值。 (继承自 DependencyObject。)

System_CAPS_pubpropertyName

获取或设置日志条目的名称。

System_CAPS_pubpropertySource

获取或设置导航到的内容的 URI。

名称说明
System_CAPS_pubpropertySystem_CAPS_staticKeepAlive

获取或设置一个值,该值指示是否日志项的内容是保留还是在导航历史记录中导航到时重新创建。

名称说明
System_CAPS_pubmethodCheckAccess()

确定调用线程是否有权访问此 DispatcherObject(继承自 DispatcherObject。)

System_CAPS_pubmethodClearValue(DependencyProperty)

清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。(继承自 DependencyObject。)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

清除只读属性的本地值。 要清除的属性由 DependencyPropertyKey 指定。(继承自 DependencyObject。)

System_CAPS_pubmethodCoerceValue(DependencyProperty)

对指定依赖属性的值进行强制。 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。(继承自 DependencyObject。)

System_CAPS_pubmethodEquals(Object)

确定提供 DependencyObject 等同于当前 DependencyObject(继承自 DependencyObject。)

System_CAPS_protmethodFinalize()

在垃圾回收将某一对象回收前允许该对象尝试释放资源并执行其他清理操作。(继承自 Object。)

System_CAPS_pubmethodGetHashCode()

获取此 DependencyObject 的哈希代码。(继承自 DependencyObject。)

System_CAPS_pubmethodSystem_CAPS_staticGetKeepAlive(DependencyObject)

返回指定元素的日记条目的附加属性 KeepAlive

System_CAPS_pubmethodGetLocalValueEnumerator()

创建专用的枚举数,用于确定哪些依赖项属性具有本地设置值,对此 DependencyObject(继承自 DependencyObject。)

System_CAPS_pubmethodSystem_CAPS_staticGetName(DependencyObject)

设置指定元素日记条目的 Name 附加属性。

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

此对象进行序列化时调用。

System_CAPS_pubmethodGetType()

获取当前实例的 Type(继承自 Object。)

System_CAPS_pubmethodGetValue(DependencyProperty)

DependencyObject 的此实例返回依赖属性的当前有效值。(继承自 DependencyObject。)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

重新计算指定的依赖项属性的有效值(继承自 DependencyObject。)

System_CAPS_protmethodMemberwiseClone()

创建当前 Object 的浅表副本。(继承自 Object。)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

每当更新此 DependencyObject 的任何依赖属性的有效值时调用。 更改的特定依赖属性将在事件数据中报告。(继承自 DependencyObject。)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

如果存在,则返回依赖属性的本地值。(继承自 DependencyObject。)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

设置依赖属性的值而不更改其值源。(继承自 DependencyObject。)

System_CAPS_pubmethodSystem_CAPS_staticSetKeepAlive(DependencyObject, Boolean)

设置指定元素的 KeepAlive 附加属性。

System_CAPS_pubmethodSystem_CAPS_staticSetName(DependencyObject, String)

设置指定元素的 Name 附加属性。

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

设置依赖属性的本地值,该值由其依赖属性标识符指定。(继承自 DependencyObject。)

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

设置一个只读依赖属性的本地值,该值由依赖属性的 DependencyPropertyKey 标识符指定。(继承自 DependencyObject。)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

返回一个值,该值指示序列化进程是否应序列化所提供的依赖属性的值。(继承自 DependencyObject。)

System_CAPS_pubmethodToString()

返回表示当前对象的字符串。(继承自 Object。)

System_CAPS_pubmethodVerifyAccess()

强制执行调用的线程有权访问此DispatcherObject(继承自 DispatcherObject。)

名称说明
System_CAPS_pubfieldSystem_CAPS_staticKeepAliveProperty

标识 KeepAlive 附加属性。

System_CAPS_pubfieldSystem_CAPS_staticNameProperty

标识 Name 附加属性。

Windows Presentation Foundation (WPF) 实现存储每个部分具有以前导航到,就像导航历史记录中的内容的一项的导航历史记录服务 Microsoft Internet Explorer。 导航历史记录包含两个堆栈,一个记住后退导航历史记录,另一个记忆前进导航历史记录。

当前项的一个条目添加后退导航历史记录向前导航时发生。 在以下情况下发生这种情况︰

同样,当前项的一个条目之前添加到前进导航历史记录后退导航发生时,发生这种情况时︰

每个条目后退和前进导航历史记录是实例 JournalEntry 类。

每个 JournalEntry 对象封装有关特定导航,包括一个名为条目的信息 (Name),无论该条目保持活动状态 (KeepAlive) 和 统一资源标识符 (URI) 导航到的内容 (Source)。

您可以检索所有 JournalEntry 通过枚举对象到底层导航历史记录 NavigationWindow.BackStackFrame.BackStack 属性。 对于前进导航历史记录,您可以检索所有 JournalEntry 对象通过枚举 NavigationWindow.ForwardStackFrame.ForwardStack 属性。

如果您需要删除最新 JournalEntry 对象后退导航历史记录,以防止例如,导航到它,您可以调用 RemoveBackEntry 方法 (NavigationService.RemoveBackEntry, ,NavigationWindow.RemoveBackEntry, ,Frame.RemoveBackEntry),哪些删除 JournalEntry 对象并返回对它的引用。

您不能添加 JournalEntry 对象添加到导航历史记录,但是,由于不能实例化或派生自 JournalEntry, ,而且因为没有任何类型实现的成员,若要这样做。 但是,您可以添加自定义 CustomContentState 对象通过调用后退导航历史记录 AddBackEntry 方法 (AddBackEntry, ,AddBackEntry, ,AddBackEntry); NavigationService 添加 CustomContentState 对象传递给内部创建 JournalEntry 对象,然后添加到导航历史记录。

下面的示例演示如何检索最新 JournalEntry 后退导航堆栈,以获取从对象 NameSource 属性值。

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.");
    }
}

.NET Framework
自 3.0 起可用
Windows Phone Silverlight
自 7.1 起可用

此类型的所有公共静态(Visual Basic 中的 已共享 在 Visual Basic 中)成员都是线程安全的。不保证所有实例成员都是线程安全的。

返回页首
显示: