Frame.GetNavigationState Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Sérialise l’historique de navigation Frame dans une chaîne.

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

Retours

String

Platform::String

winrt::hstring

Historique de navigation sérialisé sous forme de chaîne. Consultez la section Notes.

Remarques

Cette méthode est utile pour enregistrer et restaurer l’état de navigation de votre application. Pour enregistrer l’état de navigation, appelez GetNavigationState et enregistrez la valeur de retour. Pour restaurer l’état de navigation, appelez SetNavigationState et transmettez-lui la valeur enregistrée.

L’appel de cette méthode appelle Page.OnNavigatedFrom pour la page active à l’aide de NavigationMode.Forward.

Conseil

Dans une application UWP, GetNavigationState est généralement appelé lorsque l’application est suspendue et SetNavigationState est appelé lorsque l’application est reprise. Lorsque l’application est reprise après avoir été suspendue, l’utilisateur s’attend à ce qu’elle soit dans le même état.

Une application SDK d'application Windows n’a Suspending pas d’événements etResuming. Vous devez donc déterminer s’il est approprié ou non pour votre application d’enregistrer et de restaurer l’état de navigation lorsqu’un Window est fermé et activé. L’utilisateur peut ne pas s’attendre à ce que l’état de navigation soit restauré après la fermeture d’un Window. Pour plus d’informations, consultez SDK d'application Windows cycle de vie des applications.

Notes

Le format de sérialisation utilisé par ces méthodes est uniquement à usage interne. Votre application ne doit pas former de dépendances à son sujet. En outre, ce format prend en charge la sérialisation uniquement pour les types de base tels que les types string, char, numeric et GUID .

Voir aussi

• SetNavigationState