Frame.SetNavigationState メソッド

定義

名前空間:

Microsoft.UI.Xaml.Controls

オーバーロード

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

SetNavigationState(String)

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

public:
 virtual void SetNavigationState(Platform::String ^ navigationState) = SetNavigationState;

/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& 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

ナビゲーション履歴の復元ポイントを提供するシリアル化文字列。

属性

OverloadAttribute

注釈

このメソッドは、アプリのナビゲーション状態を保存および復元するのに役立ちます。 ナビゲーション状態を保存するには、 GetNavigationState を 呼び出し、戻り値を保存します。 ナビゲーション状態を復元するには、 を呼び出 SetNavigationState し、保存された値を渡します。

を呼び出すと SetNavigationState 、現在の ページの Page.OnNavigatedTo が と NavigationMode.Back呼び出されます。 SetNavigationState は通常、ウィンドウがアクティブ化されるときに呼び出されるため、現在のページに移動します。

ヒント

UWP アプリでは、 は通常、 GetNavigationState アプリが中断されたときに呼び出され SetNavigationState 、アプリが再開されたときに呼び出されます。 中断後にアプリが再開されると、ユーザーはアプリが同じ状態であると想定します。

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

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。

属性

OverloadAttribute

注釈

パラメーターを に設定して trueをsuppressNavigate呼び出SetNavigationStateした場合、現在のページに対して Page.OnNavigatedTo は呼び出されません。 現在のページも BackStack に配置されます。 切り替えを抑制する場合は、 GoBack または GoForward を使用して、ナビゲーション履歴の正しいページに移動してください。 NavigateToType もサポートされていますが、前方スタックを使用するとクリアされます。