Frame.GetNavigationState 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

将框架导航历史记录序列化为字符串。

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

String

Platform::String

winrt::hstring

字符串形式的序列化导航历史记录。请参阅“备注”。

此方法可用于保存和还原应用的导航状态。若要保存导航状态，请调用 GetNavigationState 并保存返回值。若要还原导航状态，请调用 SetNavigationState 并向其传递保存的值。

调用此方法将使用调用当前页NavigationMode.Forward的 Page.OnNavigatedFrom。

提示

在 UWP 应用中， GetNavigationState 通常在应用挂起时调用， SetNavigationState 在恢复应用时调用。当应用在暂停后恢复时，用户希望应用处于相同的状态。

Windows 应用 SDK应用没有 Suspending 和 Resuming 事件，因此应考虑是否适合应用在关闭并激活时Window保存和还原导航状态。用户可能不希望在关闭 Window后还原导航状态。有关详细信息，请参阅Windows 应用 SDK应用生命周期。

注意

这些方法使用的序列化格式仅供内部使用。你的应用不应形成任何依赖项。此外，此格式仅支持字符串、字符、数字和 GUID 类型等基本类型序列化。