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;/// [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
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.
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
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.