Frame.SetNavigationState Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| SetNavigationState(String) |
Считывает и восстанавливает журнал навигации frame из предоставленной строки сериализации. |
| SetNavigationState(String, Boolean) |
Считывает и восстанавливает журнал навигации frame из предоставленной строки сериализации. |
SetNavigationState(String)
public:
virtual void SetNavigationState(Platform::String ^ navigationState) = SetNavigationState;void SetNavigationState(winrt::hstring const& navigationState);/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& navigationState);public void SetNavigationState(string 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
Строка сериализации, которая предоставляет точку восстановления для журнала навигации.
- Атрибуты
Комментарии
Этот метод полезен для восстановления состояния навигации приложения после его приостановки и возобновления. Когда приложение приостановлено, вызовите GetNavigationState и сохраните возвращаемое значение. После возобновления работы приложения вызовите SetNavigationState и передайте ему сохраненное значение.
Вызов SetNavigationState вызовет Page.OnNavigatedTo для текущей страницы с navigationMode.Back. SetNavigationState обычно вызывается при возобновлении работы приложения, поэтому выполняется переход к текущей странице.
Применяется к
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.
- Атрибуты
Требования к 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 также поддерживается, однако при использовании стек вперед будет очищен.