Condividi tramite


Page.NavigationService Proprietà

Definizione

Ottiene il servizio di spostamento utilizzato dall'host della pagina 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à

Oggetto NavigationService utilizzato dall'host della pagina per gestire la navigazione o null se l'host non supporta lo spostamento.

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, NavigationWindowFrame, e un browser.

Le pagine spesso devono integrarsi con lo spostamento dell'host per fornire supporto per la navigazione 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 spostamento, ovvero un servizio che supporta lo spostamento in stile browser ed è incapsulato dalla NavigationService classe . Tuttavia, non è possibile creare un'istanza personalizzata NavigationService . Al contrario, i tipi host come NavigationWindow, Frameo un browser creano la propria NavigationService istanza a cui è possibile accedere dalla NavigationService proprietà .

Il servizio di spostamento 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.

Annotazioni

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

Si applica a