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
| 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;void SetNavigationState(winrt::hstring const& navigationState);/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& navigationState);public void SetNavigationState(string 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 Navigationsstatus Ihrer App wiederherzustellen, nachdem sie angehalten und fortgesetzt wurde. Wenn Ihre App angehalten wird, rufen Sie GetNavigationState auf, und speichern Sie den Rückgabewert. Wenn Ihre App fortgesetzt wird, rufen Sie SetNavigationState auf, und übergeben Sie ihr den gespeicherten Wert.
Beim Aufrufen von SetNavigationState wird Page.OnNavigatedTo für die aktuelle Seite mit NavigationMode.Back aufgerufen. SetNavigationState wird normalerweise aufgerufen, wenn die Anwendung fortgesetzt wird, sodass zur aktuellen Seite navigiert wird.
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
true , um den Navigationsverlauf wiederherzustellen, ohne zur aktuellen Seite zu navigieren; andernfalls false.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)
|
Hinweise
Wenn Sie SetNavigationState aufrufen und der Parameter suppressNavigate auf true festgelegt ist, wird Page.OnNavigatedTo für die aktuelle Seite nicht aufgerufen. Die aktuelle Seite wird auch in den BackStack eingefügt. Wenn Sie den Übergang unterdrücken, sollten Sie auch GoBack oder GoForward verwenden, um zur richtigen Seite im Navigationsverlauf zu navigieren. NavigateTo wird ebenfalls unterstützt, der Vorwärtsstapel wird jedoch gelöscht, wenn er verwendet wird.