Frame.SetNavigationState 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

오버로드

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

SetNavigationState(String)

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

public:
 virtual void SetNavigationState(Platform::String ^ navigationState) = SetNavigationState;

/// [Windows.Foundation.Metadata.Overload("SetNavigationState")]
void SetNavigationState(winrt::hstring const& 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 문자열입니다.

특성

OverloadAttribute

설명

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

를 호출 SetNavigationState 하면 를 사용하여 현재 페이지에 대해 Page.OnNavigatedTo 를 NavigationMode.Back호출합니다. SetNavigationState 는 일반적으로 창이 활성화될 때 호출되므로 현재 페이지가 탐색됩니다.

팁

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

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

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.

특성

OverloadAttribute

설명

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