NavigationService.GetNavigationService Method

Gets a reference to the NavigationService for the navigator whose content contains the specified DependencyObject.

Namespace:  System.Windows.Navigation
Assembly:  PresentationFramework (in PresentationFramework.dll)

static member GetNavigationService : 
        dependencyObject:DependencyObject -> NavigationService

Parameters

dependencyObject
Type: System.Windows.DependencyObject

The DependencyObject in content that is hosted by a navigator.

Return Value

Type: System.Windows.Navigation.NavigationService
A reference to the NavigationService for the navigator whose content contains the specified DependencyObject; can be a null reference (Nothing in Visual Basic) in some cases (see Remarks).

ExceptionCondition
ArgumentNullException

The dependencyObject parameter is a null reference (Nothing in Visual Basic).

A navigator has a NavigationService that handles content navigation. WPF has two navigators: NavigationWindow and Frame. To process navigation requests and manage navigation lifetime, a navigator uses the WPF navigation service, which is implemented as the NavigationService class. Content that is hosted by a navigator can get a reference to the navigator's NavigationService by calling the GetNavigationService method.

GetNavigationService returns a null reference (Nothing in Visual Basic) when the dependencyObject:

WPF offers two shortcuts for acquiring a reference to the NavigationService:

The following example shows how a UserControl can retrieve a navigation service by calling GetNavigationService.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft