Freigeben über

Frame.GetNavigationState Methode

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Serialisiert den Frame-Navigationsverlauf in eine Zeichenfolge.

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;
winrt::hstring GetNavigationState();
public string GetNavigationState();
function getNavigationState()
Public Function GetNavigationState () As String

Gibt zurück

String

Platform::String

winrt::hstring

Der serialisierte Navigationsverlauf im Zeichenfolgenformular. Siehe Hinweise.

Hinweise

Diese Methode ist nützlich, um den Navigationsstatus Ihrer App zu speichern und wiederherzustellen. Um den Navigationsstatus zu speichern, rufen Sie den Rückgabewert auf GetNavigationState , und speichern Sie ihn. Um den Navigationszustand wiederherzustellen, rufen Sie SetNavigationState auf, und übergeben Sie ihr den gespeicherten Wert.

Beim Aufrufen dieser Methode wird Page.OnNavigatedFrom für die aktuelle Seite mit NavigationMode.Forwardaufgerufen.

Tipp

In einer UWP-App wird normalerweise aufgerufen, GetNavigationState wenn die App angehalten wird, und SetNavigationState wird aufgerufen, wenn die App fortgesetzt wird. Wenn die App nach dem Anhalten fortgesetzt wird, erwartet der Benutzer, dass sie sich im gleichen Zustand befindet.

Eine Windows App SDK-App weist keine Suspending Ereignisse auf, Resuming daher sollten Sie überlegen, ob es für Ihre App geeignet ist, den Navigationszustand zu speichern und wiederherzustellen, wenn geschlossen Windowundaktiviert ist. Der Benutzer erwartet möglicherweise nicht, dass der Navigationszustand wiederhergestellt wird, nachdem ein Windowgeschlossen wurde. Weitere Informationen finden Sie unter Windows App SDK App-Lebenszyklus.

Hinweis

Das von diesen Methoden verwendete Serialisierungsformat ist nur zur internen Verwendung bestimmt. Ihre App sollte keine Abhängigkeiten davon bilden. Darüber hinaus unterstützt dieses Format die Serialisierung nur für grundlegende Typen wie Zeichenfolgen-, char-, numerische und GUID-Typen .

Gilt für:

Weitere Informationen