JournalEntry Kelas

Definisi

Ruang nama:

System.Windows.Navigation

Rakitan:

PresentationFramework.dll

Mewakili entri dalam riwayat navigasi kembali atau teruskan.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable

public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Warisan

Object

DispatcherObject

DependencyObject

JournalEntry

Penerapan

ISerializable

Contoh

Contoh berikut menunjukkan cara mengambil objek terbaru JournalEntry dari tumpukan navigasi belakang untuk mendapatkan Name nilai properti dan 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

Keterangan

Windows Presentation Foundation menerapkan layanan riwayat navigasi yang menyimpan satu entri untuk setiap bagian konten yang sebelumnya telah dinavigasi, sama seperti riwayat navigasi di browser. Riwayat navigasi terdiri dari dua tumpukan, satu yang mengingat kembali riwayat navigasi, dan yang mengingat riwayat navigasi penerusan.

Entri untuk item saat ini ditambahkan ke kembali riwayat navigasi ketika navigasi maju terjadi. Ini terjadi dalam situasi berikut:

• Metode Navigate ini disebut (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Metode GoForward ini disebut (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Tombol teruskan pada antarmuka pengguna navigasi yang ditampilkan dari navigator saat ini (XBAP, NavigationWindow, Frame).

Demikian juga, entri untuk item saat ini ditambahkan untuk meneruskan riwayat navigasi sebelum navigasi kembali terjadi, yang terjadi ketika:

• Metode GoBack ini disebut (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Tombol kembali pada antarmuka pengguna navigasi yang ditampilkan dari navigator saat ini (XBAP, NavigationWindow, Frame).

Setiap entri dalam riwayat navigasi belakang dan maju adalah instans JournalEntry kelas .

Setiap JournalEntry objek merangkum informasi tentang navigasi tertentu, termasuk nama untuk entri (Name), apakah entri tetap hidup (KeepAlive) dan pengidentifikasi sumber daya seragam (URI) untuk konten yang dinavigasi ke (Source).

Anda dapat mengambil semua JournalEntry objek di riwayat navigasi belakang dengan menghitung NavigationWindow.BackStack properti atau Frame.BackStack . Untuk riwayat navigasi penerusan, Anda dapat mengambil semua JournalEntry objek dengan menghitung NavigationWindow.ForwardStack properti atau Frame.ForwardStack .

Jika Anda perlu menghapus objek terbaru JournalEntry dari riwayat navigasi belakang, untuk mencegah navigasi ke sana, misalnya, Anda dapat memanggil RemoveBackEntry metode (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, ), Frame.RemoveBackEntryyang menghapus JournalEntry objek dan mengembalikan referensi ke sana.

Namun, Anda tidak dapat menambahkan JournalEntry objek ke riwayat navigasi karena Anda tidak dapat membuat instans atau berasal dari JournalEntry, dan karena tidak ada jenis yang mengimplementasikan anggota untuk melakukannya. Namun, Anda dapat menambahkan objek kustom CustomContentState ke riwayat navigasi kembali dengan memanggil AddBackEntry metode (AddBackEntry, , AddBackEntryAddBackEntry); NavigationService menambahkan CustomContentState objek ke objek yang dibuat JournalEntry secara internal, yang kemudian ditambahkan ke riwayat navigasi belakang.

Konstruktor

JournalEntry(SerializationInfo, StreamingContext)

Menginisialisasi instans baru kelas JournalEntry.

Bidang

KeepAliveProperty	KeepAlive Mengidentifikasi properti terlampir.
NameProperty	Name Mengidentifikasi properti terlampir.

Properti

CustomContentState	Mendapatkan atau mengatur CustomContentState objek yang terkait dengan entri jurnal ini.
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Name	Mendapatkan atau menetapkan nama entri jurnal.
Source	Mendapatkan atau mengatur URI konten yang dinavigasi.

Properti yang Terlampir

KeepAlive

Mendapatkan atau menetapkan nilai yang menunjukkan apakah konten entri jurnal dipertahankan atau dibuat ulang saat dinavigasi dalam riwayat navigasi.

Metode

CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetKeepAlive(DependencyObject)	Mengembalikan KeepAlive properti terlampir dari entri jurnal untuk elemen yang ditentukan.
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetName(DependencyObject)	Name Mendapatkan properti terlampir dari entri jurnal untuk elemen yang ditentukan.
GetObjectData(SerializationInfo, StreamingContext)	Dipanggil ketika objek ini diserialisasikan.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi ulang nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	KeepAlive Mengatur properti terlampir dari elemen yang ditentukan.
SetName(DependencyObject, String)	Name Mengatur properti terlampir dari elemen yang ditentukan.
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)