Frame.GetNavigationState Метод

Определение

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

Microsoft.UI.Xaml.Controls

Сериализует журнал навигации frame в строку.

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

Возвращаемое значение

String

Platform::String

winrt::hstring

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

Комментарии

Этот метод полезен для сохранения и восстановления состояния навигации приложения. Чтобы сохранить состояние навигации, вызовите GetNavigationState и сохраните возвращаемое значение. Чтобы восстановить состояние навигации, вызовите SetNavigationState и передайте ему сохраненное значение.

Вызов этого метода приведет к вызову Page.OnNavigatedFrom для текущей страницы с помощью NavigationMode.Forward.

Совет

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

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

Примечание

Формат сериализации, используемый этими методами, предназначен только для внутреннего использования. Ваше приложение не должно формировать зависимости от него. Кроме того, этот формат поддерживает сериализацию только для базовых типов, таких как string, char, numeric и GUID .

См. также раздел

• SetNavigationState