Frame.SetNavigationState Método

Definição

Namespace:

Windows.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 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.

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

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.