다음을 통해 공유


Frame.SetNavigationState 메서드

정의

오버로드

SetNavigationState(String)

제공된 serialization 문자열에서 Frame 의 탐색 기록을 읽고 복원합니다.

SetNavigationState(String, Boolean)

제공된 serialization 문자열에서 Frame 의 탐색 기록을 읽고 복원합니다.

SetNavigationState(String)

제공된 serialization 문자열에서 Frame 의 탐색 기록을 읽고 복원합니다.

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

탐색 기록에 대한 복원 지점을 제공하는 serialization 문자열입니다.

특성

설명

이 메서드는 앱이 일시 중단되고 다시 시작된 후 앱의 탐색 상태를 복원하는 데 유용합니다. 앱이 일시 중단되면 GetNavigationState 를 호출하고 반환 값을 저장합니다. 앱이 다시 시작되면 SetNavigationState 를 호출하고 저장된 값을 전달합니다.

SetNavigationState를 호출하면 NavigationMode.Back을 사용하여 현재 페이지에 대해 Page.OnNavigatedTo를 호출합니다. SetNavigationState 는 일반적으로 애플리케이션이 다시 시작될 때 호출되므로 현재 페이지가 탐색됩니다.

적용 대상

SetNavigationState(String, Boolean)

제공된 serialization 문자열에서 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

탐색 기록에 대한 복원 지점을 제공하는 serialization 문자열입니다.

suppressNavigate
Boolean

bool

true 이면 현재 페이지로 이동하지 않고 탐색 기록을 복원합니다. 그렇지 않으면 false입니다.

특성

Windows 요구 사항

디바이스 패밀리
Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

설명

suppressNavigate 매개 변수가 true로 설정된 SetNavigationState를 호출하는 경우 Page.OnNavigatedTo는 현재 페이지에 대해 호출되지 않습니다. 현재 페이지도 BackStack에 배치됩니다. 전환을 표시하지 않을 때 GoBack 또는 GoForward를 사용하여 탐색 기록에서 올바른 페이지로 이동해야 합니다. NavigateTo도 지원되지만 정방향 스택은 사용될 때 지워집니다.

적용 대상