Frame.SetNavigationState Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Sobrecargas

SetNavigationState(String)	Lê e restaura o histórico de navegação de um Frame de uma cadeia de caracteres de serialização fornecida.
SetNavigationState(String, Boolean)	Lê e restaura o histórico de navegação de um Frame de uma cadeia de caracteres de serialização fornecida.

SetNavigationState(String)

Lê e restaura o histórico de navegação de um Frame de uma cadeia de caracteres de serialização fornecida.

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)

Parâmetros

navigationState

String

Platform::String

winrt::hstring

A cadeia de caracteres de serialização que fornece o ponto de restauração para o histórico de navegação.

Atributos

OverloadAttribute

Comentários

Esse método é útil para salvar e restaurar o estado de navegação do 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 SetNavigationState chamará Page.OnNavigatedTo para a página atual, com NavigationMode.Back. SetNavigationState geralmente é chamado quando a Janela é ativada, portanto, a página atual é navegada para.

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 para seu aplicativo salvar e restaurar 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 o fechamento de um Window. Para obter mais informações, consulte SDK do Aplicativo Windows ciclo de vida do aplicativo.

SetNavigationState(String, Boolean)

Lê e restaura o histórico de navegação de um Frame de uma cadeia de caracteres de serialização fornecida.

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)

Parâmetros

navigationState

String

Platform::String

winrt::hstring

A cadeia de caracteres de serialização que fornece o ponto de restauração para o histórico de navegação.

suppressNavigate

Boolean

bool

true para restaurar o histórico de navegação sem navegar até a página atual; caso contrário, false.

Atributos

OverloadAttribute

Comentários

Se você chamar SetNavigationState com o suppressNavigate parâmetro definido como true, Page.OnNavigatedTo não será chamado para a página atual. A página atual também é colocada no BackStack. Ao suprimir a transição, também use GoBack ou GoForward para navegar até a página correta no histórico de navegação. O NavigateToType também tem suporte, no entanto, a pilha de encaminhamento será desmarcada quando for usada.