Frame.SetNavigationState Methode

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ü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;

/// [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

OverloadAttribute

Hinweise

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

Beim Aufrufen SetNavigationState wird Page.OnNavigatedTo für die aktuelle Seite mit NavigationMode.Backaufgerufen. SetNavigationState wird normalerweise aufgerufen, wenn das Fenster aktiviert wird, sodass die aktuelle Seite navigiert wird.

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.

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; falseandernfalls .

Attribute

OverloadAttribute

Hinweise

Wenn Sie aufrufen SetNavigationState , wenn der suppressNavigate Parameter auf truefestgelegt 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. NavigateToType wird ebenfalls unterstützt, aber der Vorwärtsstapel wird gelöscht, wenn er verwendet wird.