Page.NavigationService Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Получает службу переходов, которую сайт страницы использует для управления переходами.

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

Значение свойства

NavigationService

Объект NavigationService, который сайт страницы использует для управления переходами, или null, если сайт не поддерживает переходы.

Примеры

В следующем примере показано, как страница может проверить, доступна ли служба навигации, и, если да, используйте ее для возврата к предыдущей странице.

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

Комментарии

Страницы могут размещаться несколькими типами узлов, включая Window, NavigationWindowи Frameбраузер.

Страницы часто необходимо интегрировать с навигацией узла, чтобы обеспечить поддержку навигации на странице. Тем не менее, поскольку страница может не знать, какой узел будет находиться во время выполнения, она не может напрямую интегрироваться с элементами навигации узла, чтобы сделать это.

Вместо этого он может попытаться использовать службу навигации, которая является службой, которая поддерживает навигацию в стиле браузера и инкапсулируется классом NavigationService . Однако вы не можете создать собственный NavigationService экземпляр. Вместо этого типы узлов, такие как NavigationWindow, Frameили браузер, создают собственный NavigationService экземпляр, к которому можно получить доступ из NavigationService свойства.

Служба навигации, возвращаемая из NavigationService свойства, является экземпляром класса, управляемого NavigationService первым навигатором вверх по визуальному дереву. Если он не найден, возвращается значение, null указывающее, что узел страницы не поддерживает навигацию.

Примечание

Класс Window не поддерживает навигацию и не предоставляет службу навигации.