Frame.SetNavigationState メソッド

定義

オーバーロード

SetNavigationState(String)

指定されたシリアル化文字列から Frame のナビゲーション履歴を読み取って復元します。

SetNavigationState(String, Boolean)

指定されたシリアル化文字列から Frame のナビゲーション履歴を読み取って復元します。

SetNavigationState(String)

指定されたシリアル化文字列から Frame のナビゲーション履歴を読み取って復元します。

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)

指定されたシリアル化文字列から 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

属性

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 もサポートされていますが、前方スタックを使用するとクリアされます。

適用対象