Frame.GetNavigationState Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Serializa o histórico de navegação frame em uma cadeia de caracteres.

public:
 virtual Platform::String ^ GetNavigationState() = GetNavigationState;

winrt::hstring GetNavigationState();

public string GetNavigationState();

function getNavigationState()

Public Function GetNavigationState () As String

Retornos

String

Platform::String

winrt::hstring

O histórico de navegação serializado de forma de cadeia de caracteres. Consulte Observações.

Comentários

Esse método é útil para salvar e restaurar o estado de navegação do seu aplicativo. Para salvar o estado de navegação, chame GetNavigationState e salve o valor retornado. Para restaurar o estado de navegação, chame SetNavigationState e passe o valor salvo.

Chamar esse método chamará Page.OnNavigatedFrom para a página atual usando NavigationMode.Forward.

Dica

Em um aplicativo UWP, GetNavigationState normalmente é chamado quando o aplicativo é suspenso e SetNavigationState é chamado quando o aplicativo é retomado. Quando o aplicativo é retomado após ser suspenso, o usuário espera que ele esteja no mesmo estado.

Um aplicativo SDK do Aplicativo Windows não tem Suspending eventos e Resuming , portanto, você deve considerar se é apropriado ou não que seu aplicativo salve e restaure o estado de navegação quando um Window é Fechado e Ativado. O usuário pode não esperar que o estado de navegação seja restaurado após fechar um Window. Para obter mais informações, consulte SDK do Aplicativo Windows ciclo de vida do aplicativo.

Observação

O formato de serialização usado por esses métodos é apenas para uso interno. Seu aplicativo não deve formar nenhuma dependência nele. Além disso, esse formato dá suporte à serialização somente para tipos básicos como tipos de cadeia de caracteres, char, numérico e GUID .

Confira também

• SetNavigationState