Frame.GetNavigationState メソッド

定義

フレーム ナビゲーション履歴を文字列にシリアル化します。

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 イベントがないため、 が Closedアクティブ化されたときにWindowナビゲーション状態を保存して復元することがアプリに適しているかどうかを検討する必要があります。 ユーザーは、 を閉じた Window後にナビゲーション状態が復元されるとは思わない場合があります。 詳細については、「アプリのライフサイクルWindows アプリ SDK」を参照してください。

注意

これらのメソッドで使用されるシリアル化形式は、内部でのみ使用されます。 アプリは、それに対する依存関係を形成しないでください。 さらに、この形式では、string、char、numeric、 GUID 型などの基本型に対してのみシリアル化がサポートされます。

適用対象

こちらもご覧ください