Page.NavigationService Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera usługę nawigacji używaną przez hosta strony do zarządzania nawigacją.

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

Wartość właściwości

NavigationService

NavigationService Obiekt, którego host strony używa do zarządzania nawigacją, lub null jeśli host nie obsługuje nawigacji.

Przykłady

W poniższym przykładzie pokazano, jak strona może sprawdzić, czy usługa nawigacji jest dostępna, a jeśli tak, użyj jej, aby wrócić do poprzedniej strony.

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

Uwagi

Strony mogą być hostowane przez wiele typów hostów, w tym Window, NavigationWindowFrame, i przeglądarki.

Strony często muszą być zintegrowane z nawigacją hosta w celu zapewnienia obsługi nawigacji na stronie. Jednak ze względu na to, że strona może nie wiedzieć, jaki będzie jego host w czasie wykonywania, nie może zintegrować jej bezpośrednio z członkami nawigacji hosta w tym celu.

Zamiast tego może podjąć próbę użycia usługi nawigacji, która jest usługą, która obsługuje nawigację w stylu przeglądarki i jest hermetyzowana przez klasę NavigationService . Nie można jednak utworzyć własnego NavigationService wystąpienia. Zamiast tego typy hostów, takie jak NavigationWindow, Framelub przeglądarka, tworzą własne NavigationService wystąpienie, do którego można uzyskać dostęp z NavigationService właściwości .

Usługa nawigacji zwrócona z NavigationService właściwości to wystąpienie NavigationService klasy zarządzanej przez pierwszy nawigator drzewa wizualnego. Jeśli jeden nie zostanie znaleziony, null zostanie zwrócony komunikat wskazujący, że host strony nie obsługuje nawigacji.

Uwaga

Klasa Window nie obsługuje nawigacji i nie zapewnia usługi nawigacji.