Frame.SetNavigationState 方法

定义

重载

SetNavigationState(String)

从提供的序列化字符串读取和还原 Frame 的导航历史记录。

SetNavigationState(String, Boolean)

从提供的序列化字符串读取和还原 Frame 的导航历史记录。

SetNavigationState(String)

从提供的序列化字符串读取和还原 Frame 的导航历史记录。

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)

参数

navigationState
String

Platform::String

winrt::hstring

为导航历史记录提供还原点的序列化字符串。

属性

注解

此方法可用于在应用暂停和恢复后还原其导航状态。 应用暂停后,调用 GetNavigationState 并保存返回值。 恢复应用后,调用 SetNavigationState 并向其传递保存的值。

调用 SetNavigationState 将使用 NavigationMode.Back 调用当前页的 Page.OnNavigatedTo。 恢复应用程序时,通常会调用 SetNavigationState,因此当前页将导航到 。

适用于

SetNavigationState(String, Boolean)

从提供的序列化字符串读取和还原 Frame 的导航历史记录。

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)

参数

navigationState
String

Platform::String

winrt::hstring

为导航历史记录提供还原点的序列化字符串。

suppressNavigate
Boolean

bool

如果为 true ,则还原导航历史记录,而无需导航到当前页;否则为 false

属性

Windows 要求

设备系列
Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

如果在 suppressNavigate 参数设置为 true 的情况下调用 SetNavigationState,则不会为当前页调用 Page.OnNavigatedTo。 当前页也会放入 BackStack 中。 禁止转换时,请确保使用 GoBack 或 GoForward 导航到导航历史记录中的正确页面。 也支持 NavigateTo,但使用前向堆栈时会清除它。

适用于