Page.NavigationService Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtém o serviço de navegação que o host da página está usando para gerenciar a navegação.

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

Valor da propriedade

NavigationService

O objeto NavigationService que o host da página está usando para gerenciar a navegação ou null, se o host não der suporte à navegação.

Exemplos

O exemplo a seguir mostra como uma página pode verificar se um serviço de navegação está disponível e, nesse caso, usá-lo para navegar de volta para a página anterior.

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

Comentários

As páginas podem ser hospedadas por vários tipos de hosts, incluindoWindow, NavigationWindowFramee um navegador.

As páginas geralmente precisam se integrar à navegação do host para fornecer suporte à navegação na página. No entanto, como uma página pode não saber qual será o host em tempo de execução, ela não pode se integrar diretamente aos membros de navegação do host para fazer isso.

Em vez disso, ele pode tentar usar um serviço de navegação, que é um serviço que dá suporte à navegação no estilo navegador e é encapsulado pela NavigationService classe. No entanto, você não pode criar sua própria NavigationService instância. Em vez disso, tipos de host, como NavigationWindow, Frameou um navegador, criam sua própria NavigationService instância que você pode acessar da NavigationService propriedade.

O serviço de navegação retornado da NavigationService propriedade é a instância da NavigationService classe que é gerenciada pelo primeiro navegador até a árvore visual. Se um não for encontrado, null será retornado, indicando que o host de uma página não dá suporte à navegação.

Observação

A Window classe não dá suporte à navegação e não fornece um serviço de navegação.