NavigationService.GetNavigationService(DependencyObject) Méthode

Définition

Espace de noms:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Obtient une référence à NavigationService destinée au navigateur dont le contenu contient l'objet DependencyObject spécifié.

public:
 static System::Windows::Navigation::NavigationService ^ GetNavigationService(System::Windows::DependencyObject ^ dependencyObject);

public static System.Windows.Navigation.NavigationService GetNavigationService (System.Windows.DependencyObject dependencyObject);

static member GetNavigationService : System.Windows.DependencyObject -> System.Windows.Navigation.NavigationService

Public Shared Function GetNavigationService (dependencyObject As DependencyObject) As NavigationService

Paramètres

dependencyObject

DependencyObject

DependencyObject dans le contenu hébergé par un navigateur.

Retours

NavigationService

Référence au NavigationService destinée au navigateur dont le contenu comprend le DependencyObject spécifié ; peut être null dans certains cas.

Exceptions

ArgumentNullException

Le paramètre dependencyObject a la valeur null.

Exemples

L’exemple suivant montre comment un UserControl service de navigation peut récupérer un service de navigation en appelant GetNavigationService.

void getNavigationServiceButton_Click(object sender, RoutedEventArgs e) {
    // Retrieve first navigation service up the content tree
    NavigationService svc = NavigationService.GetNavigationService(this.getNavigationServiceButton);
    if (svc != null)
    {
        // Use navigation service

Private Sub getNavigationServiceButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Retrieve first navigation service up the content tree
    Dim svc As NavigationService = NavigationService.GetNavigationService(Me.getNavigationServiceButton)
    If svc IsNot Nothing Then
        ' Use navigation service

    }
}

    End If
End Sub

Remarques

Un navigateur dispose d’un NavigationService navigateur qui gère la navigation dans le contenu. WPF a deux navigateurs : NavigationWindow et Frame. Pour traiter les demandes de navigation et gérer la durée de vie de la navigation, un navigateur utilise le service de navigation WPF, qui est implémenté en tant que NavigationService classe. Le contenu hébergé par un navigateur peut obtenir une référence aux navigateurs NavigationService en appelant la GetNavigationService méthode.

GetNavigationServiceretourne null lorsque :dependencyObject

• Est un NavigationWindow.

• C’est ce Frame qui suit :

  1. Est hébergé par un autre navigateur.

  2. JournalOwnership Sa propriété a la valeur UsesParentJournal.

• Ne fait pas partie du contenu hébergé par un navigateur.

WPF offre deux raccourcis pour acquérir une référence à :NavigationService

• Celui NavigationService qui a traité la navigation vers un accès à partir Page de lui-même Page en obtenant la valeur de sa Page.NavigationService propriété.

• Celui NavigationService utilisé par un Frame processus de navigation est accessible en obtenant la valeur de la NavigationService propriété.