Frame.GetNavigationState 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

將 框架 瀏覽歷程記錄串行化為字串。

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

傳回

String

Platform::String

winrt::hstring

字串形式的串行化導覽歷程記錄。 請參閱＜備註＞。

備註

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

呼叫這個方法會使用NavigationMode.Forward呼叫目前頁面的Page.OnNavigatedFrom。

提示

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

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

注意

這些方法所使用的串行化格式僅供內部使用。 您的應用程式不應該形成任何相依性。 此外，此格式僅支援字串、char、數值和 GUID 類型等基本型別的串行化。

另請參閱

• SetNavigationState