Frame.GetNavigationState 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

프레임 탐색 기록을 문자열로 직렬화합니다.

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 를 호출하고 저장된 값을 전달합니다.

이 메서드를 호출하면 를 사용하여 NavigationMode.Forward현재 페이지에 대해 Page.OnNavigatedFrom을 호출합니다.

팁

UWP 앱 GetNavigationState 에서 는 일반적으로 앱이 일시 중단될 때 호출되며 SetNavigationState 앱이 다시 시작될 때 호출됩니다. 일시 중단된 후 앱이 다시 시작되면 사용자는 앱이 동일한 상태일 것으로 예상합니다.

Windows 앱 SDK 앱에는 Suspending 및 Resuming 이벤트가 없으므로 가 닫힘 및 활성화된 경우 Window 앱이 탐색 상태를 저장하고 복원하는 것이 적절한지 여부를 고려해야 합니다. 사용자는 를 닫 Window은 후 탐색 상태가 복원될 것으로 예상하지 않을 수 있습니다. 자세한 내용은 Windows 앱 SDK 앱 수명 주기를 참조하세요.

참고

이러한 메서드에서 사용하는 serialization 형식은 내부 전용입니다. 앱이 종속성을 형성해서는 안 됩니다. 또한 이 형식은 문자열, 문자, 숫자 및 GUID 형식과 같은 기본 형식에 대해서만 serialization을 지원합니다.

추가 정보

• SetNavigationState