共用方式為


Frame.SetNavigationState 方法

定義

多載

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

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

屬性

備註

這個方法有助於儲存和還原應用程式的瀏覽狀態。 若要儲存瀏覽狀態,請呼叫 GetNavigationState 並儲存傳回值。 若要還原瀏覽狀態,請呼叫 SetNavigationState 並傳遞儲存的值。

呼叫 SetNavigationState 將會針對目前頁面呼叫 Page.OnNavigatedTo ,並使用 NavigationMode.BackSetNavigationState 通常會在啟動 Window 時呼叫 ,因此會巡覽至目前的頁面。

提示

在 UWP 應用程式中, GetNavigationState 通常會在應用程式暫停時呼叫,並在 SetNavigationState 應用程式繼續時呼叫。 當應用程式在暫停後繼續時,使用者預期其處於相同的狀態。

Windows 應用程式 SDK 應用程式沒有 SuspendingResuming 事件,因此您應該考慮是否適合您的應用程式在關閉和啟用Window儲存和還原瀏覽狀態。 關閉 之後 Window,使用者可能不會預期要還原導覽狀態。 如需詳細資訊,請參閱應用程式生命週期 Windows 應用程式 SDK

適用於

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

屬性

備註

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

適用於