Frame.GetNavigationState Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Serializza la cronologia di navigazione frame in una stringa.

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

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

Restituisce

String

Platform::String

winrt::hstring

Cronologia di navigazione serializzata in formato stringa. Vedere la sezione Osservazioni.

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 al valore salvato.

La chiamata a questo metodo chiamerà Page.OnNavigatedFrom per la pagina corrente usando NavigationMode.Forward.

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.

Nota

Il formato di serializzazione usato da questi metodi è solo per uso interno. L'app non deve formare alcuna dipendenza da essa. Inoltre, questo formato supporta la serializzazione solo per i tipi di base, ad esempio string, char, numeric e GUID .

Vedi anche

• SetNavigationState