Язык

Frame.SetNavigationState Метод

Определение

Пространство имен:
Microsoft.UI.Xaml.Controls

Перегрузки

Имя Описание
SetNavigationState(String)

Считывает и восстанавливает журнал навигации кадра из предоставленной строки сериализации.
SetNavigationState(String, Boolean)

Считывает и восстанавливает журнал навигации кадра из предоставленной строки сериализации.

SetNavigationState(String)

Изменить

Считывает и восстанавливает журнал навигации кадра из предоставленной строки сериализации.

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

Tip

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

Приложение Windows App SDK не имеет Suspending и Resuming событий, поэтому следует учитывать, подходит ли оно для сохранения и восстановления состояния навигации при Windowзакрытии и активации. Пользователь может не ожидать восстановления состояния навигации после закрытия Window. Дополнительные сведения см. в разделе Windows App SDK жизненном цикле приложений.

Применяется к

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в противном случае .

Атрибуты
OverloadAttribute

Комментарии

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

Применяется к