Partilhar via


Frame.SetNavigationState Método

Definição

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;
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)

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

Comentários

Esse método é útil para restaurar o estado de navegação do seu aplicativo depois que ele tiver sido suspenso e retomado. Quando o aplicativo for suspenso, chame GetNavigationState e salve o valor retornado. Quando o aplicativo for retomado, chame SetNavigationState e passe o valor salvo.

Chamar SetNavigationState chamará Page.OnNavigatedTo para a página atual, com NavigationMode.Back. SetNavigationState geralmente é chamado quando o aplicativo está sendo retomado, portanto, a página atual é navegada para.

Aplica-se a

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

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Se você chamar SetNavigationState com o parâmetro suppressNavigate 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, use também GoBack ou GoForward para navegar até a página correta no histórico de navegação. O NavigateTo também tem suporte, no entanto, a pilha de encaminhamento será desmarcada quando for usada.

Aplica-se a