Frame.SetNavigationState 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| SetNavigationState(String) |
從提供的序列化字串讀取和還原 Frame 的流覽歷程記錄。 |
| SetNavigationState(String, Boolean) |
從提供的序列化字串讀取和還原 Frame 的流覽歷程記錄。 |
SetNavigationState(String)
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
提供導覽歷程記錄之還原點的序列化字串。
- 屬性
備註
這個方法有助於在 App 暫停和繼續之後還原應用程式的流覽狀態。 當您的應用程式暫停時，請呼叫 GetNavigationState 並儲存傳回值。 當您的應用程式繼續執行時，請呼叫 SetNavigationState 並將儲存的值傳遞給它。
呼叫SetNavigationState將會使用NavigationMode.Back呼叫目前頁面的Page.OnNavigatedTo。 SetNavigationState 通常會在應用程式繼續時呼叫，因此會巡覽至目前的頁面。
適用於
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。
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 Creators Update (已於 10.0.15063.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v4.0 引進)
|
備註
如果您呼叫 SetNavigationState 且 suppressNavigate 參數設定為 true，則不會針對目前頁面呼叫 Page.OnNavigatedTo 。 目前的頁面也會放入 BackStack 中。 隱藏轉換時，也請務必使用 GoBack 或 GoForward 流覽至流覽歷程記錄中的正確頁面。 也支援 NavigateTo，不過使用向前堆疊時，將會清除該堆疊。