Frame.SetNavigationState Methode

Definition

Namespace:

Windows.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 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.

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

OverloadAttribute

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.