Frame.SetNavigationState Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Overload

SetNavigationState(String)	Legge e ripristina la cronologia di navigazione di un frame da una stringa di serializzazione specificata.
SetNavigationState(String, Boolean)	Legge e ripristina la cronologia di navigazione di un frame da una stringa di serializzazione specificata.

SetNavigationState(String)

Legge e ripristina la cronologia di navigazione di un frame da una stringa di serializzazione specificata.

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)

Parametri

navigationState

String

Platform::String

winrt::hstring

Stringa di serializzazione che fornisce il punto di ripristino per la cronologia di navigazione.

Attributi

OverloadAttribute

Commenti

Questo metodo è utile per salvare e ripristinare lo stato di spostamento dell'app. Per salvare lo stato di navigazione, chiamare GetNavigationState e salvare il valore restituito. Per ripristinare lo stato di navigazione, chiamare SetNavigationState e passarlo il valore salvato.

La chiamata SetNavigationState chiama Page.OnNavigatedTo per la pagina corrente, con NavigationMode.Back. SetNavigationState viene in genere chiamato quando la finestra viene attivata, quindi la pagina corrente viene spostata su .

Suggerimento

In un'app UWP, GetNavigationState viene in genere chiamato quando l'app viene sospesa e SetNavigationState viene chiamata quando l'app viene ripresa. Quando l'app viene ripresa dopo essere stata sospesa, l'utente si aspetta che si tratti dello stesso stato.

Un'app SDK per app di Windows non include Suspending eventi ed Resuming è quindi consigliabile valutare se è appropriato per l'app salvare e ripristinare lo stato di spostamento quando un Window oggetto è Chiuso e Attivato. L'utente potrebbe non aspettarsi che lo stato di navigazione venga ripristinato dopo la chiusura di un oggetto Window. Per altre info, vedi SDK per app di Windows ciclo di vita dell'app.

SetNavigationState(String, Boolean)

Legge e ripristina la cronologia di navigazione di un frame da una stringa di serializzazione specificata.

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)

Parametri

navigationState

String

Platform::String

winrt::hstring

Stringa di serializzazione che fornisce il punto di ripristino per la cronologia di navigazione.

suppressNavigate

Boolean

bool

true per ripristinare la cronologia di navigazione senza passare alla pagina corrente; in caso contrario, false.

Attributi

OverloadAttribute

Commenti

Se si chiama SetNavigationState con il suppressNavigate parametro impostato su true, Page.OnNavigatedTo non viene chiamato per la pagina corrente. La pagina corrente viene inserita anche in BackStack. Quando si elimina la transizione, assicurarsi anche di usare GoBack o GoForward per passare alla pagina corretta nella cronologia di navigazione. NavigateToType è supportato anche, ma lo stack di inoltro verrà cancellato quando viene usato.