Page.NavigationService Properti

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mendapatkan layanan navigasi yang digunakan host halaman untuk mengelola navigasi.

public:
 property System::Windows::Navigation::NavigationService ^ NavigationService { System::Windows::Navigation::NavigationService ^ get(); };

public System.Windows.Navigation.NavigationService NavigationService { get; }

member this.NavigationService : System.Windows.Navigation.NavigationService

Public ReadOnly Property NavigationService As NavigationService

Nilai Properti

NavigationService

Objek NavigationService yang digunakan host halaman untuk mengelola navigasi, atau null jika host tidak mendukung navigasi.

Contoh

Contoh berikut menunjukkan bagaimana halaman dapat memeriksa apakah layanan navigasi tersedia dan, jika demikian, gunakan untuk menavigasi kembali ke halaman sebelumnya.

public partial class HomePage : Page
{
    public HomePage()
    {
        InitializeComponent();

        // Don't allow back navigation if no navigation service
        if (this.NavigationService == null)
        {
            this.goBackButton.IsEnabled = false;
        }
    }

    void goBackButton_Click(object sender, RoutedEventArgs e)
    {
        // Go to previous entry in journal back stack
        if (this.NavigationService.CanGoBack)
        {
            this.NavigationService.GoBack();
        }
    }
}

Partial Public Class HomePage
    Inherits Page
    Public Sub New()
        InitializeComponent()

        ' Don't allow back navigation if no navigation service
        If Me.NavigationService Is Nothing Then
            Me.goBackButton.IsEnabled = False
        End If
    End Sub

    Private Sub goBackButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Go to previous entry in journal back stack
        If Me.NavigationService.CanGoBack Then
            Me.NavigationService.GoBack()
        End If
    End Sub
End Class

Keterangan

Halaman dapat dihosting oleh beberapa jenis host, termasuk Window, , NavigationWindowFrame, dan browser.

Halaman sering kali perlu diintegrasikan dengan navigasi host mereka untuk menyediakan dukungan navigasi dalam halaman. Namun, karena halaman mungkin tidak tahu apa hostnya pada waktu proses, halaman tersebut tidak dapat berintegrasi langsung dengan anggota navigasi hostnya untuk melakukannya.

Sebaliknya, ia dapat mencoba menggunakan layanan navigasi, yang merupakan layanan yang mendukung navigasi gaya browser dan dienkapsulasi oleh NavigationService kelas . Namun, Anda tidak dapat membuat instans Anda sendiri NavigationService . Sebagai gantinya, jenis host seperti NavigationWindow, Frame, atau browser membuat instans mereka sendiri NavigationService yang dapat Anda akses dari NavigationService properti .

Layanan navigasi yang dikembalikan dari NavigationService properti adalah instans NavigationService kelas yang dikelola oleh navigator pertama di atas pohon visual. Jika tidak ditemukan, null dikembalikan, menunjukkan host halaman tidak mendukung navigasi.

Nota

Kelas Window tidak mendukung navigasi dan tidak menyediakan layanan navigasi.