共用方式為


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

提供導覽歷程記錄之還原點的序列化字串。

屬性

備註

這個方法有助於在 App 暫停和繼續之後還原應用程式的流覽狀態。 當您的應用程式暫停時,請呼叫 GetNavigationState 並儲存傳回值。 當您的應用程式繼續執行時,請呼叫 SetNavigationState 並將儲存的值傳遞給它。

呼叫SetNavigationState將會使用NavigationMode.Back呼叫目前頁面的Page.OnNavigatedToSetNavigationState 通常會在應用程式繼續時呼叫,因此會巡覽至目前的頁面。

適用於

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 引進)

備註

如果您呼叫 SetNavigationStatesuppressNavigate 參數設定為 true,則不會針對目前頁面呼叫 Page.OnNavigatedTo 。 目前的頁面也會放入 BackStack 中。 隱藏轉換時,也請務必使用 GoBack 或 GoForward 流覽至流覽歷程記錄中的正確頁面。 也支援 NavigateTo,不過使用向前堆疊時,將會清除該堆疊。

適用於