Frame.GetNavigationState メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public:
virtual Platform::String ^ GetNavigationState() = GetNavigationState;winrt::hstring GetNavigationState();public string GetNavigationState();function getNavigationState()Public Function GetNavigationState () As String戻り値
文字列形式のシリアル化されたナビゲーション履歴。 「解説」を参照してください。
注釈
このメソッドは、アプリのナビゲーション状態を保存して復元する場合に便利です。 ナビゲーション状態を保存するには、 を呼び出 GetNavigationState して戻り値を保存します。 ナビゲーション状態を復元するには、 SetNavigationState を呼び出し、保存された値を渡します。
このメソッドを呼び出すと、 を使用してNavigationMode.Forward現在のページに対して Page.OnNavigatedFrom が呼び出されます。
ヒント
UWP アプリでは、 GetNavigationState は通常、アプリが中断されたときに呼び出され SetNavigationState 、アプリが再開されたときに呼び出されます。 中断後にアプリが再開されると、ユーザーはアプリが同じ状態であると想定します。
Windows アプリ SDK アプリには Suspending イベントと Resuming イベントがないため、 が Closed でアクティブ化されたときにWindowナビゲーション状態を保存して復元することがアプリに適しているかどうかを検討する必要があります。 ユーザーは、 を閉じた Window後にナビゲーション状態が復元されるとは思わない場合があります。 詳細については、「アプリのライフサイクルWindows アプリ SDK」を参照してください。
注意
これらのメソッドで使用されるシリアル化形式は、内部でのみ使用されます。 アプリは、それに対する依存関係を形成しないでください。 さらに、この形式では、string、char、numeric、 GUID 型などの基本型に対してのみシリアル化がサポートされます。