Frame.SetNavigationState Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| SetNavigationState(String) |
Liest und stellt den Navigationsverlauf eines Frame- aus einer bereitgestellten Serialisierungszeichenfolge wieder her. |
| SetNavigationState(String, Boolean) |
Liest und stellt den Navigationsverlauf eines Frame- aus einer bereitgestellten Serialisierungszeichenfolge wieder her. |
SetNavigationState(String)
Liest und stellt den Navigationsverlauf eines Frame- aus einer bereitgestellten Serialisierungszeichenfolge wieder her.
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)Parameter
- navigationState
-
String
Platform::String
winrt::hstring
Die Serialisierungszeichenfolge, die den Wiederherstellungspunkt für den Navigationsverlauf bereitstellt.
- Attribute
Hinweise
Diese Methode ist nützlich, um den Navigationszustand Ihrer App zu speichern und wiederherzustellen. Rufen Sie GetNavigationState auf, und speichern Sie den Rückgabewert, um den Navigationszustand zu speichern. Rufen Sie SetNavigationState zum Wiederherstellen des Navigationszustands den gespeicherten Wert auf, und übergeben Sie ihn.
Anrufe SetNavigationState rufen Page.OnNavigatedTo für die aktuelle Seite mit NavigationMode.Back.
SetNavigationState wird in der Regel aufgerufen, wenn das Fenster aktiviert wird, sodass die aktuelle Seite navigiert wird.
Tip
In einer UWP-App wird normalerweise aufgerufen, GetNavigationState wenn die App angehalten wird und SetNavigationState aufgerufen wird, 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 verfügt nicht Suspending über und Resuming Ereignisse, daher sollten Sie überlegen, ob es für Ihre App geeignet ist, den Navigationszustand zu speichern und wiederherzustellen, wenn ein Windowgeschlossen und aktiviert ist. Der Benutzer erwartet möglicherweise nicht, dass der Navigationszustand nach dem Schließen eines Window. Weitere Informationen finden Sie unter Windows App SDK App-Lebenszyklus.
Gilt für:
SetNavigationState(String, Boolean)
Liest und stellt den Navigationsverlauf eines Frame- aus einer bereitgestellten Serialisierungszeichenfolge wieder her.
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)Parameter
- navigationState
-
String
Platform::String
winrt::hstring
Die Serialisierungszeichenfolge, die den Wiederherstellungspunkt für den Navigationsverlauf bereitstellt.
- suppressNavigate
-
Boolean
bool
trueum den Navigationsverlauf wiederherzustellen, ohne zur aktuellen Seite zu navigieren; andernfalls . false
- Attribute
Hinweise
Wenn Sie SetNavigationState den Parameter aufrufen, der suppressNavigate auf true" Page.OnNavigatedTo " festgelegt ist, wird für die aktuelle Seite nicht aufgerufen. Die aktuelle Seite wird auch in den BackStack eingefügt. Achten Sie beim Unterdrücken des Übergangs auch darauf, dass Sie goBack oder GoForward verwenden, um zur richtigen Seite im Navigationsverlauf zu navigieren.
NavigateToType wird auch unterstützt, der Vorwärtsstapel wird jedoch gelöscht, wenn er verwendet wird.