Frame.SetNavigationState 方法

定義

命名空間:

Windows.UI.Xaml.Controls

多載

SetNavigationState(String)	從提供的序列化字串讀取和還原 Frame 的流覽歷程記錄。
SetNavigationState(String, Boolean)	從提供的序列化字串讀取和還原 Frame 的流覽歷程記錄。

SetNavigationState(String)

從提供的序列化字串讀取和還原 Frame 的流覽歷程記錄。

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

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

屬性

OverloadAttribute

備註

這個方法有助於在 App 暫停和繼續之後還原應用程式的流覽狀態。 當您的應用程式暫停時，請呼叫 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。

屬性

OverloadAttribute

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，不過使用向前堆疊時，將會清除該堆疊。