Frame.SetNavigationState 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
SetNavigationState(String) |
제공된 serialization 문자열에서 Frame 의 탐색 기록을 읽고 복원합니다. |
SetNavigationState(String, Boolean) |
제공된 serialization 문자열에서 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
탐색 기록에 대한 복원 지점을 제공하는 serialization 문자열입니다.
- 특성
설명
이 메서드는 앱이 일시 중단되고 다시 시작된 후 앱의 탐색 상태를 복원하는 데 유용합니다. 앱이 일시 중단되면 GetNavigationState 를 호출하고 반환 값을 저장합니다. 앱이 다시 시작되면 SetNavigationState 를 호출하고 저장된 값을 전달합니다.
SetNavigationState를 호출하면 NavigationMode.Back을 사용하여 현재 페이지에 대해 Page.OnNavigatedTo를 호출합니다. 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
탐색 기록에 대한 복원 지점을 제공하는 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도 지원되지만 정방향 스택은 사용될 때 지워집니다.