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 обычно вызывается при активации окна, поэтому выполняется переход к текущей странице.

Совет

В приложении GetNavigationState UWP обычно вызывается, когда приложение приостановлено, и SetNavigationState вызывается при возобновлении работы приложения. Когда приложение возобновляется после приостановки, пользователь ожидает, что оно будет находиться в том же состоянии.

Приложение Windows App SDK не имеет Suspending событий и Resuming , поэтому следует подумать, подходит ли для вашего приложения сохранение и восстановление состояния навигации, когда Window для параметра задано значение "Закрыто" и "Активировано". Пользователь может не ожидать восстановления состояния навигации после закрытия Window. Дополнительные сведения см. в Windows App 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

Комментарии

При вызове SetNavigationState с параметром suppressNavigate , равным true, Page.OnNavigatedTo не вызывается для текущей страницы. Текущая страница также помещается в BackStack. При подавлении перехода также обязательно используйте GoBack или GoForward для перехода на правильную страницу в журнале навигации. NavigateToType также поддерживается, однако при использовании стек вперед будет очищен.