Frame.SetNavigationState メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| SetNavigationState(String) |
指定されたシリアル化文字列から Frame のナビゲーション履歴を読み取って復元します。 |
| SetNavigationState(String, Boolean) |
指定されたシリアル化文字列から Frame のナビゲーション履歴を読み取って復元します。 |
SetNavigationState(String)
public:
virtual void SetNavigationState(Platform::String ^ navigationState) = SetNavigationState;void SetNavigationState(winrt::hstring const& navigationState);/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& navigationState);public void SetNavigationState(string 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 を呼び出すと、NavigationMode.Back を使用して、現在のページに対して Page.OnNavigatedTo が呼び出されます。 SetNavigationState は通常、アプリケーションの再開時に呼び出されるため、現在のページに移動します。
適用対象
SetNavigationState(String, Boolean)
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。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 Creators Update (10.0.15063.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v4.0 で導入)
|
注釈
suppressNavigate パラメーターを true に設定して SetNavigationState を呼び出した場合、現在のページに対して Page.OnNavigatedTo は呼び出されません。 現在のページも BackStack に配置されます。 切り替えを抑制する場合は、GoBack または GoForward を使用して、ナビゲーション履歴の正しいページに移動してください。 NavigateTo もサポートされていますが、前方スタックを使用するとクリアされます。