Frame.SetNavigationState Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Surcharges

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)

Lit et restaure l’historique de navigation d’un frame à partir d’une chaîne de sérialisation fournie.

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

OverloadAttribute

Remarques

Cette méthode est utile pour restaurer l’état de navigation de votre application après sa suspension et sa reprise. Lorsque votre application est suspendue, appelez GetNavigationState et enregistrez la valeur de retour. Lorsque votre application reprend, appelez SetNavigationState et transmettez-lui la valeur enregistrée.

L’appel de SetNavigationState appelle Page.OnNavigatedTo pour la page active, avec NavigationMode.Back. SetNavigationState est généralement appelé lorsque l’application est en cours de reprise, de sorte que la page active est parcourue.

SetNavigationState(String, Boolean)

Lit et restaure l’historique de navigation d’un frame à partir d’une chaîne de sérialisation fournie.

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

OverloadAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Remarques

Si vous appelez SetNavigationState avec le paramètre suppressNavigate défini sur true, Page.OnNavigatedTo n’est pas appelé pour la page active. La page active est également placée dans backstack. Lorsque vous supprimez la transition, veillez également à utiliser GoBack ou GoForward pour accéder à la page appropriée dans l’historique de navigation. NavigateTo est également pris en charge, mais la pile avant est effacée lorsqu’elle est utilisée.