Export (0) Print
Expand All

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)

'Declaration
Public Shared Function GetNavigationService ( _
	dependencyObject As DependencyObject _
) As 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 Nothing in some cases (see Remarks).

ExceptionCondition
ArgumentNullException

The dependencyObject parameter is Nothing.

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 Nothing 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.

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

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft