Frame.SetNavigationState Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| SetNavigationState(String) |
Lit et restaure l’historique de navigation d’un Frame à partir d’une chaîne de sérialisation fournie. |
| SetNavigationState(String, Boolean) |
Lit et restaure l’historique de navigation d’un Frame à partir d’une chaîne de sérialisation fournie. |
SetNavigationState(String)
public:
virtual void SetNavigationState(Platform::String ^ navigationState) = SetNavigationState;/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& navigationState);[Windows.Foundation.Metadata.Overload("SetNavigationState")]
public void SetNavigationState(string navigationState);function setNavigationState(navigationState)Public Sub SetNavigationState (navigationState As String)Paramètres
- navigationState
-
String
Platform::String
winrt::hstring
Chaîne de sérialisation qui fournit le point de restauration pour l’historique de navigation.
- Attributs
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-le la valeur enregistrée.
L’appel SetNavigationState appelle Page.OnNavigatedTo pour la page active, avec NavigationMode.Back.
SetNavigationState est généralement appelé lorsque la fenêtre est activée, de sorte que la page active est accédée.
Tip
Dans une application UWP, GetNavigationState elle est généralement appelée lorsque l’application est suspendue et SetNavigationState est appelée lorsque l’application est reprise. Lorsque l’application est reprise après avoir été suspendue, l’utilisateur s’attend à ce qu’il soit dans le même état.
Une application SDK d'application Windows n'a Suspending pas et Resuming n'a pas d'événements. Vous devez donc déterminer s'il est approprié ou non que votre application enregistre et restaure l'état de navigation lorsqu'une Window application est fermée et activée. L’utilisateur peut ne pas s’attendre à ce que l’état de navigation soit restauré après avoir fermé un Window. Pour plus d’informations, consultez SDK d'application Windows cycle de vie des applications.
S’applique à
SetNavigationState(String, Boolean)
public:
virtual void SetNavigationState(Platform::String ^ navigationState, bool suppressNavigate) = SetNavigationState;/// [Windows.Foundation.Metadata.Overload("SetNavigationStateWithNavigationControl")]
void SetNavigationState(winrt::hstring const& navigationState, bool const& suppressNavigate);[Windows.Foundation.Metadata.Overload("SetNavigationStateWithNavigationControl")]
public void SetNavigationState(string navigationState, bool suppressNavigate);function setNavigationState(navigationState, suppressNavigate)Public Sub SetNavigationState (navigationState As String, suppressNavigate As Boolean)Paramètres
- navigationState
-
String
Platform::String
winrt::hstring
Chaîne de sérialisation qui fournit le point de restauration pour l’historique de navigation.
- suppressNavigate
-
Boolean
bool
true pour restaurer l’historique de navigation sans accéder à la page active ; sinon, false.
- Attributs
Remarques
Si vous appelez SetNavigationState avec le suppressNavigate paramètre défini sur true, Page.OnNavigatedTo n’est pas appelé pour la page active. La page active est également placée dans BackStack. Lors de la suppression de la transition, veillez également à utiliser GoBack ou GoForward pour accéder à la page appropriée dans l’historique de navigation.
NavigateToType est également pris en charge, mais la pile vers l’avant est effacée lorsqu’elle est utilisée.