Frame.SetNavigationState 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| SetNavigationState(String) |
从提供的序列化字符串读取和还原 Frame 的导航历史记录。 |
| SetNavigationState(String, Boolean) |
从提供的序列化字符串读取和还原 Frame 的导航历史记录。 |
SetNavigationState(String)
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)参数
- navigationState
-
String
Platform::String
winrt::hstring
为导航历史记录提供还原点的序列化字符串。
- 属性
注解
此方法可用于保存和还原应用的导航状态。 若要保存导航状态，请调用 GetNavigationState 并保存返回值。 若要还原导航状态，请调用 SetNavigationState 并向其传递保存的值。
调用 SetNavigationState 将使用 调用当前页NavigationMode.Back的 Page.OnNavigatedTo。
SetNavigationState 通常在激活窗口时调用 ，以便导航到当前页。
提示
在 UWP 应用中， GetNavigationState 通常在应用暂停时调用， SetNavigationState 在应用恢复时调用。 当应用在暂停后恢复时，用户预期它处于相同的状态。
Windows 应用 SDK应用没有 Suspending 和 Resuming 事件，因此应考虑应用是否适合在 处于关闭和激活状态时Window保存和还原导航状态。 用户可能不希望在关闭 Window后还原导航状态。 有关详细信息，请参阅Windows 应用 SDK应用生命周期。
适用于
SetNavigationState(String, Boolean)
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。
- 属性
注解
如果在将 参数设置为 true的情况下suppressNavigate调用 SetNavigationState ，则不会为当前页调用 Page.OnNavigatedTo。 当前页也会放入 BackStack 中。 禁止转换时，还请务必使用 GoBack 或 GoForward 导航到导航历史记录中的正确页面。
NavigateToType 也受支持，但使用前向堆栈时将清除它。