Page.NavigationService Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.