Page.NavigationService Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient le service de navigation que l'hôte de la page utilise pour gérer la navigation.

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

Valeur de propriété

NavigationService

L'objet NavigationService que l'hôte de la page utilise pour gérer la navigation, ou null si l'hôte ne prend pas en charge la navigation.

Exemples

L’exemple suivant montre comment une page peut vérifier si un service de navigation est disponible et, si tel est le cas, utilisez-le pour revenir à la page précédente.

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

Remarques

Les pages peuvent être hébergées par plusieurs types d’hôtes, notamment Window, NavigationWindow, Frameet un navigateur.

Les pages doivent souvent s’intégrer à la navigation de leur hôte pour fournir une prise en charge de la navigation dans la page. Toutefois, étant donné qu’une page ne sait peut-être pas ce que son hôte sera au moment de l’exécution, elle ne peut pas s’intégrer directement aux membres de navigation de son hôte pour le faire.

Au lieu de cela, il peut tenter d’utiliser un service de navigation, qui est un service qui prend en charge la navigation de style navigateur et est encapsulé par la NavigationService classe. Vous ne pouvez pas créer votre propre NavigationService instance. Au lieu de cela, les types d’hôtes tels que NavigationWindow, Frameou un navigateur créent leur propre NavigationService instance que vous pouvez accéder à partir de la NavigationService propriété.

Le service de navigation retourné à partir de la propriété est l’instance de la NavigationService NavigationService classe gérée par le premier navigateur de l’arborescence visuelle. Si l’un n’est pas trouvé, est retourné, null indiquant que l’hôte d’une page ne prend pas en charge la navigation.

Notes

La classe ne prend pas en charge la Window navigation et ne fournit pas de service de navigation.