Page.NavigationService Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Controls

Ensamblado:: PresentationFramework.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene el servicio de navegación que está utilizando el host de la página para administrar la navegación.

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 propiedad

NavigationService

El objeto NavigationService que está utilizando el host de la página para administrar la navegación o null si el host no admite la navegación.

Ejemplos

En el ejemplo siguiente se muestra cómo una página puede comprobar si un servicio de navegación está disponible y, si es así, úselo para volver a la 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

Comentarios

Las páginas se pueden hospedar en varios tipos de hosts, incluidos Window, NavigationWindow, Framey un explorador.

Las páginas suelen necesitar integrarse con la navegación de su host para proporcionar compatibilidad con la navegación en la página. Sin embargo, dado que es posible que una página no sepa cuál será su host en tiempo de ejecución, no se puede integrar directamente con los miembros de navegación de su host para hacerlo.

En su lugar, puede intentar usar un servicio de navegación, que es un servicio que admite navegación de estilo explorador y está encapsulado por la NavigationService clase . Sin embargo, no puede crear su propia NavigationService instancia. En su lugar, los tipos de host como NavigationWindow, Frameo un explorador crean su propia NavigationService instancia a la que puede acceder desde la NavigationService propiedad .

El servicio de navegación que se devuelve de la NavigationService propiedad es la instancia de la NavigationService clase administrada por el primer navegador en el árbol visual. Si no se encuentra uno, null se devuelve , lo que indica que el host de una página no admite la navegación.

Nota

La Window clase no admite la navegación y no proporciona un servicio de navegación.

Se aplica a

Producto	Versiones
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Compartir a través de