Frame.SetNavigationState Метод

Определение

Пространство имен:

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

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

Требования к Windows

Семейство устройств	Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v4.0)

Комментарии

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