NavigatingCancelEventArgs Kelas

Definisi

Ruang nama:

System.Windows.Navigation

Rakitan:

PresentationFramework.dll

Menyediakan data untuk peristiwa Navigasi .

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Warisan

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Contoh

Contoh berikut menunjukkan cara menangani Navigating untuk mendeteksi apakah permintaan untuk me-refresh konten statis dibuat, dan jika ada, cara membatalkan permintaan.

Navigating.

void NavigationService_Navigating(object sender, NavigatingCancelEventArgs e)
{
    // Don't allow refreshing of a static page
    if ((e.NavigationMode == NavigationMode.Refresh) &&
        (e.Uri.OriginalString == "StaticPage.xaml"))
    {
        e.Cancel = true;
    }
}

Private Sub NavigationService_Navigating(ByVal sender As Object, ByVal e As NavigatingCancelEventArgs)
    ' Don't allow refreshing of a static page
    If (e.NavigationMode = NavigationMode.Refresh) AndAlso (e.Uri.OriginalString = "StaticPage.xaml") Then
        e.Cancel = True
    End If
End Sub

Keterangan

Argumen peristiwa ini berisi informasi tentang navigasi yang diminta, dan diteruskan ke penangan peristiwa Navigasi , yang diimplementasikan oleh hal berikut:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs merangkum detail permintaan navigasi berikut:

• Inisiasi Navigasi: NavigationMode, Navigator, IsNavigationInitiator.

• Konten Navigasi: Uri, Content.

• Permintaan Navigasi: WebRequest.

• Status Navigasi: ExtraData, ContentStateToSave, TargetContentState.

Informasi ini memungkinkan Anda untuk mengevaluasi sifat permintaan navigasi, dan melihat dan memperbarui detail permintaan yang ditentukan sebelum navigasi terjadi.

Berdasarkan informasi permintaan navigasi yang disediakan oleh NavigatingCancelEventArgs, atau berdasarkan status atau kode khusus aplikasi, Anda dapat sepenuhnya mencegah navigasi dengan mengatur Cancel properti ke true (secara default, Cancel adalah false).

Properti

Cancel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah acara harus dibatalkan. (Diperoleh dari CancelEventArgs)
Content	Mendapatkan referensi ke objek konten yang sedang dinavigasi.
ContentStateToSave	Mendapatkan atau mengatur CustomContentState objek yang terkait dengan entri riwayat navigasi belakang untuk halaman yang dinavigasi.
ExtraData	Mendapatkan data Object opsional yang diteruskan saat navigasi dimulai.
IsNavigationInitiator	Menunjukkan apakah navigator (NavigationWindow, Frame) yang ditentukan oleh Navigator melayani navigasi ini, atau apakah navigator induk melakukannya.
NavigationMode	NavigationMode Mendapatkan nilai yang menunjukkan jenis navigasi yang terjadi.
Navigator	Navigator yang mengangkat peristiwa ini.
TargetContentState	CustomContentState Mendapatkan objek yang akan diterapkan ke konten yang sedang dinavigasi.
Uri	Mendapatkan pengidentifikasi sumber daya seragam (URI) untuk konten yang dinavigasi.
WebRequest	WebRequest Mendapatkan objek yang digunakan untuk meminta konten yang ditentukan.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Navigating