Frame.SetNavigationState Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)
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)
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.