Frame.SetNavigationState 方法

定義

命名空間:

Microsoft.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

備註

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

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

提示

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

Windows 應用程式 SDK 應用程式沒有 Suspending 和 Resuming 事件，因此您應該考慮是否適合您的應用程式在關閉和啟用時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。

屬性

OverloadAttribute

備註

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