Frame.GetNavigationState Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
public:
virtual Platform::String ^ GetNavigationState() = GetNavigationState;
winrt::hstring GetNavigationState();
public string GetNavigationState();
function getNavigationState()
Public Function GetNavigationState () As String
Restituisce
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 .