IProvideCustomContentState Antarmuka

Definisi

Ruang nama:

System.Windows.Navigation

Rakitan:

PresentationFramework.dll

Diimplementasikan oleh kelas yang perlu menambahkan status kustom ke entri riwayat navigasi untuk konten sebelum konten dinavigasi menjauh.

public interface class IProvideCustomContentState

public interface IProvideCustomContentState

type IProvideCustomContentState = interface

Public Interface IProvideCustomContentState

Keterangan

IProvideCustomContentState memungkinkan Anda mengaitkan bagian status kustom, yang diimplementasikan sebagai kelas kustom CustomContentState , dengan entri riwayat navigasi untuk konten yang telah dinavigasi menjauh.

Status kustom juga dapat dikaitkan dengan cara ini dengan menggunakan hal berikut:

• Memanggil AddBackEntry:

  • NavigationService.AddBackEntry

  • NavigationWindow.AddBackEntry

  • Frame.AddBackEntry.

• Pengaturan NavigatingCancelEventArgs.Content saat salah satu peristiwa berikut dinaikkan:

  • NavigationService.Navigating

  • NavigationWindow.Navigating

  • Frame.Navigating

  • NavigationWindow.Navigating

Anda harus menerapkan IProvideCustomContentState saat menambahkan status kustom ke riwayat navigasi dengan memanggil AddBackEntry, jika tidak, riwayat navigasi tidak akan berfungsi dengan benar; pertimbangkan langkah-langkah berikut:

1. AddBackEntry dipanggil untuk mengaitkan status kustom dengan konten saat ini.

2. Entri riwayat navigasi dinavigasi kembali ke, dan Replay metode status kustom dipanggil, dan status diterapkan ke konten.

3. Konten sebelumnya dinavigasi ke dalam riwayat navigasi penerusan.

4. Entri riwayat navigasi dinavigasi kembali, tetapi status kustom belum dipertahankan sejak terakhir kali entri riwayat navigasi yang terkait dengannya dinavigasi.

Ini adalah perilaku default karena status yang awalnya direkam dalam status kustom dapat berubah setelah ditambahkan ke riwayat navigasi. Jika objek status kustom dinavigasi kembali ke dan statusnya diterapkan, sebelum beberapa aspek tentang perubahan status sebelum entri dalam riwayat navigasi dinavigasi, perubahan status tidak dapat tercermin dalam objek status kustom. Selain itu, AddBackEntry tidak dapat secara eksplisit dipanggil untuk menambahkan objek status kustom baru yang mencerminkan perubahan status. Akibatnya, untuk memastikan status saat ini untuk navigasi tertentu selalu disimpan dalam riwayat navigasi, GetContentState dipanggil.

Important

Saat menyimpan informasi dalam status konten kustom, Anda tidak dapat menyimpan referensi apa pun ke instans halaman yang statusnya Anda ingat. Ini mencegah WPF merilis instans halaman, dan mengalahkan tujuan perilaku riwayat navigasi default. Jika Anda harus melakukan ini, Anda mungkin mempertimbangkan untuk menggunakan KeepAlive sebagai gantinya.

Metode

Nama	Deskripsi
GetContentState()	Mengembalikan instans kelas status kustom yang akan dikaitkan dengan konten dalam riwayat navigasi.