JournalEntry Sınıf

Tanım

Geri ya da İleri gezinti geçmişinde bir girişi temsil eder.Represents an entry in either back or forward navigation history.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable
public 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
[<System.Serializable>]
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable
Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable
Devralma
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki örnek, JournalEntry Name ve özellik değerlerini almak için arka gezinti yığınından en son nesnenin nasıl alınacağını gösterir 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

Açıklamalar

Windows Presentation Foundation, ' de gezinti geçmişi gibi, daha önce gittiği her içerik parçası için bir giriş depolayan bir gezinti geçmişi hizmeti uygular 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. Gezinti geçmişi iki yığın içerir, bir tane, geriye doğru Gezinme geçmişini anımsar ve bir tane ileri gezinti geçmişini hatırlar.Navigation history comprises two stacks, one that remembers back navigation history, and one that remembers forward navigation history.

Bir ileriye doğru gezinme gerçekleştiğinde, geri gezinti geçmişine geçerli öğe için bir giriş eklenir.An entry for the current item is added to back navigation history when a forward navigation occurs. Bu durum aşağıdaki durumlarda oluşur:This occurs in the following situations:

Benzer şekilde, geçerli öğe için bir giriş, geri gezinme gerçekleşmeden önce ileriye doğru gezinme geçmişine eklenir ve şu durumlarda gerçekleşir:Likewise, an entry for the current item is added to forward navigation history before a back navigation occurs, which happens when:

Geri ve İleri gezinti geçmişindeki her giriş, sınıfının bir örneğidir JournalEntry .Each entry in back and forward navigation history is an instance of the JournalEntry class.

Her JournalEntry nesne belirli bir gezinti hakkındaki bilgileri, girişin bir adı () Name , girişin Canlı tutulup tutulmadığını () KeepAlive ve () öğesine gidildiği içerik için Tekdüzen Kaynak tanımlayıcısını (URI) dahil olmak üzere saklar 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).

JournalEntryVeya özelliklerini numaralandırarak geri gezinti geçmişindeki tüm nesneleri alabilirsiniz NavigationWindow.BackStack Frame.BackStack .You can retrieve all the JournalEntry objects in back navigation history by enumerating the NavigationWindow.BackStack or Frame.BackStack properties. İleri gezinme geçmişi için, JournalEntry veya özelliklerini numaralandırarak tüm nesneleri alabilirsiniz NavigationWindow.ForwardStack Frame.ForwardStack .For forward navigation history, you can retrieve all the JournalEntry objects by enumerating the NavigationWindow.ForwardStack or Frame.ForwardStack properties.

En son JournalEntry nesneyi geri gezinti geçmişinden kaldırmanız gerekirse, bu nesnenin gezinmesini engellemek için, örneğin, RemoveBackEntry NavigationService.RemoveBackEntry NavigationWindow.RemoveBackEntry Frame.RemoveBackEntry JournalEntry nesneyi kaldıran ve buna bir başvuru döndüren yöntemini (,,) çağırabilirsiniz.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.

JournalEntryAncak, JournalEntry hiçbir tür hiçbir üye uyguladığından ve öğesinden türetebilmeniz için gezinti geçmişine nesne ekleyemezsiniz.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. Ancak, CustomContentState yöntemini çağırarak (,,), arka gezinti geçmişine özel nesneler ekleyebilirsiniz AddBackEntry AddBackEntry AddBackEntry AddBackEntry NavigationService CustomContentState . nesneyi, JournalEntry daha sonra geri gezinti geçmişine eklenen, dahili olarak oluşturulan bir nesneye ekler.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.

Oluşturucular

JournalEntry(SerializationInfo, StreamingContext)

JournalEntry sınıfının yeni bir örneğini başlatır.Initializes a new instance of the JournalEntry class.

Alanlar

KeepAliveProperty

KeepAliveİliştirilmiş özelliği tanımlar.Identifies the KeepAlive attached property.

NameProperty

Nameİliştirilmiş özelliği tanımlar.Identifies the Name attached property.

Özellikler

CustomContentState

CustomContentStateBu günlük girdisiyle ilişkilendirilmiş nesneyi alır veya ayarlar.Gets or sets the CustomContentState object that is associated with this journal entry.

DependencyObjectType

DependencyObjectTypeBu örneğin türünü sarmalayan öğesini alır CLRCLR .Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Devralındığı yer: DependencyObject)
Dispatcher

Dispatcher DispatcherObject İle ilişkili olduğunu alır.Gets the Dispatcher this DispatcherObject is associated with.

(Devralındığı yer: DispatcherObject)
IsSealed

Bu örneğin şu anda kapalı olup olmadığını gösteren bir değer alır (salt okunurdur).Gets a value that indicates whether this instance is currently sealed (read-only).

(Devralındığı yer: DependencyObject)
Name

Günlük girişinin adını alır veya ayarlar.Gets or sets the name of the journal entry.

Source

Gezindiği içeriğin URI 'sini alır veya ayarlar.Gets or sets the URI of the content that was navigated to.

İliştirilmiş Özellikler

KeepAlive

Gezinti geçmişinde gezindiği sırada bir günlük girişi içeriğinin korunup korunmadığını veya yeniden oluşturulup oluşturulmayacağını gösteren bir değer alır veya ayarlar.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.

Yöntemler

CheckAccess()

Çağıran iş parçacığının bu öğesine erişip erişemeyeceğini belirler DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)

Bir özelliğin yerel değerini temizler.Clears the local value of a property. Temizlenme özelliği bir tanımlayıcı tarafından belirtilir DependencyProperty .The property to be cleared is specified by a DependencyProperty identifier.

(Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)

Salt okunurdur özelliğinin yerel değerini temizler.Clears the local value of a read-only property. Temizlenme özelliği bir tarafından belirtilir DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Devralındığı yer: DependencyObject)
CoerceValue(DependencyProperty)

Belirtilen bağımlılık özelliğinin değerini zorlar.Coerces the value of the specified dependency property. Bu, CoerceValueCallback çağırma üzerinde olduğu gibi bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir işlevi çağırarak gerçekleştirilir DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Devralındığı yer: DependencyObject)
Equals(Object)

Belirtilen değerin geçerli olup olmadığını belirler DependencyObject DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Devralındığı yer: DependencyObject)
GetHashCode()

Bunun için bir karma kodu alır DependencyObject .Gets a hash code for this DependencyObject.

(Devralındığı yer: DependencyObject)
GetKeepAlive(DependencyObject)

KeepAliveBelirtilen öğe için günlük girişinin iliştirilmiş özelliğini döndürür.Returns the KeepAlive attached property of the journal entry for the specified element.

GetLocalValueEnumerator()

Hangi bağımlılık özelliklerinin bunun üzerinde yerel olarak değer ayarlamış olduğunu belirlemek için özel bir Numaralandırıcı oluşturur DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Devralındığı yer: DependencyObject)
GetName(DependencyObject)

NameBelirtilen öğe için günlük girişinin iliştirilmiş özelliğini alır.Gets the Name attached property of the journal entry for the specified element.

GetObjectData(SerializationInfo, StreamingContext)

Bu nesne serileştirildiğinde çağırılır.Called when this object is serialized.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
GetValue(DependencyProperty)

Bir bağımlılık özelliğinin bu örneğine ait geçerli etkin değeri döndürür DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)

Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir.Re-evaluates the effective value for the specified dependency property.

(Devralındığı yer: DependencyObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Bunun üzerinde herhangi bir bağımlılık özelliğinin etkin değeri DependencyObject güncelleştirildiğinde çağrılır.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Değiştirilen belirli bağımlılık özelliği olay verilerinde raporlanır.The specific dependency property that changed is reported in the event data.

(Devralındığı yer: DependencyObject)
ReadLocalValue(DependencyProperty)

Varsa, bağımlılık özelliğinin yerel değerini döndürür.Returns the local value of a dependency property, if it exists.

(Devralındığı yer: DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar.Sets the value of a dependency property without changing its value source.

(Devralındığı yer: DependencyObject)
SetKeepAlive(DependencyObject, Boolean)

KeepAliveBelirtilen öğenin ekli özelliğini ayarlar.Sets the KeepAlive attached property of the specified element.

SetName(DependencyObject, String)

NameBelirtilen öğenin ekli özelliğini ayarlar.Sets the Name attached property of the specified element.

SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir Dependency özelliğinin yerel değerini ayarlar.Sets the local value of a dependency property, specified by its dependency property identifier.

(Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)

Bir salt okuma bağımlılığı özelliğinin yerel değerini, DependencyPropertyKey bağımlılık özelliğinin tanımlayıcısıyla belirtilen şekilde ayarlar.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Serileştirme işlemlerinin, belirtilen bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini belirten bir değer döndürür.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Devralındığı yer: DependencyObject)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
VerifyAccess()

Çağıran iş parçacığının buna erişimi olmasını zorlar DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)

Şunlara uygulanır