Page.NavigationService Proprietà

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ottiene il servizio di navigazione che l'host della pagina sta utilizzando per gestire la navigazione.

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

Valore della proprietà

NavigationService

L'oggetto NavigationService che l'host della pagina sta utilizzando per gestire la navigazione o null se l'host non supporta la navigazione.

Esempio

Nell'esempio seguente viene illustrato come una pagina può verificare se un servizio di spostamento è disponibile e, in tal caso, usarlo per tornare alla pagina precedente.

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

Commenti

Le pagine possono essere ospitate da più tipi di host, tra cui Window, NavigationWindow, Framee un browser.

Le pagine spesso devono integrarsi con la struttura di spostamento dell'host per fornire supporto per lo spostamento nella pagina. Tuttavia, poiché una pagina potrebbe non sapere quale host sarà in fase di esecuzione, non può integrarsi direttamente con i membri di navigazione dell'host per farlo.

Può invece tentare di usare un servizio di navigazione, ovvero un servizio che supporta la navigazione in stile browser e viene incapsulato dalla NavigationService classe . Non è tuttavia possibile creare un'istanza personalizzata NavigationService . I tipi di host, NavigationWindowad esempio , Frameo un browser, creano invece la NavigationService propria NavigationService istanza a cui è possibile accedere dalla proprietà .

Il servizio di navigazione restituito dalla NavigationService proprietà è l'istanza della NavigationService classe gestita dal primo strumento di navigazione nella struttura ad albero visuale. Se non viene trovato, null viene restituito , a indicare che l'host di una pagina non supporta lo spostamento.

Nota

La Window classe non supporta la navigazione e non fornisce un servizio di navigazione.