Page.NavigationService Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe o serviço de navegação que o anfitrião da página está a usar para gerir 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 de Propriedade
O NavigationService objeto que o anfitrião da página está a usar para gerir a navegação, ou null se o anfitrião não suportar navegação.
Exemplos
O exemplo seguinte mostra como uma página pode verificar se um serviço de navegação está disponível e, em caso afirmativo, usá-lo para voltar à 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
Observações
As páginas podem ser alojadas por vários tipos de hosts, incluindo Window, NavigationWindow, Frame, e um navegador.
As páginas muitas vezes precisam de se integrar com a navegação do seu anfitrião para fornecer suporte de navegação dentro da página. No entanto, como uma página pode não saber qual será o seu anfitrião em tempo de execução, não pode integrar-se diretamente com os membros de navegação do anfitrião para o fazer.
Em vez disso, pode tentar usar um serviço de navegação, que é um serviço que suporta navegação ao estilo navegador e é encapsulado pela NavigationService classe. No entanto, não podes criar a tua própria NavigationService instância. Em vez disso, tipos de host como NavigationWindow, Frame, ou um navegador criam a sua própria NavigationService instância à qual pode aceder a partir da NavigationService propriedade.
O serviço de navegação que é devolvido da NavigationService propriedade é a instância da NavigationService classe que é gerida pelo primeiro navegador na árvore visual. Se não for encontrado um, null é devolvido, indicando que o host da página não suporta navegação.
Note
A Window classe não suporta navegação nem fornece serviço de navegação.