Frame.SetNavigationState Método

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Sobrecargas

SetNavigationState(String)	Lee y restaura el historial de navegación de un marco a partir de una cadena de serialización proporcionada.
SetNavigationState(String, Boolean)	Lee y restaura el historial de navegación de un marco a partir de una cadena de serialización proporcionada.

SetNavigationState(String)

Lee y restaura el historial de navegación de un marco a partir de una cadena de serialización proporcionada.

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

Cadena de serialización que proporciona el punto de restauración para el historial de navegación.

Atributos

OverloadAttribute

Comentarios

Este método es útil para guardar y restaurar el estado de navegación de la aplicación. Para guardar el estado de navegación, llame a GetNavigationState y guarde el valor devuelto. Para restaurar el estado de navegación, llame SetNavigationState a y páselo el valor guardado.

La llamada SetNavigationState llamará a Page.OnNavigatedTo para la página actual, con NavigationMode.Back. SetNavigationState normalmente se llama cuando se activa la ventana, por lo que se navega a la página actual.

Sugerencia

En una aplicación para UWP, GetNavigationState normalmente se llama cuando se suspende la aplicación y SetNavigationState se llama cuando se reanuda la aplicación. Cuando la aplicación se reanuda después de suspenderse, el usuario espera que esté en el mismo estado.

Una aplicación SDK de Aplicaciones para Windows no tiene Suspending eventos y Resuming , por lo que debes considerar si es adecuado para que la aplicación guarde y restaure el estado de navegación cuando se cierra y se activa.Window Es posible que el usuario no espere que se restaure el estado de navegación después de cerrar .Window Para obtener más información, consulta SDK de Aplicaciones para Windows ciclo de vida de la aplicación.

SetNavigationState(String, Boolean)

Lee y restaura el historial de navegación de un marco a partir de una cadena de serialización proporcionada.

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

Cadena de serialización que proporciona el punto de restauración para el historial de navegación.

suppressNavigate

Boolean

bool

true para restaurar el historial de navegación sin navegar a la página actual; de lo contrario, false.

Atributos

OverloadAttribute

Comentarios

Si llama a SetNavigationState con el suppressNavigate parámetro establecido en true, no se llama a Page.OnNavigatedTo para la página actual. La página actual también se coloca en BackStack. Al suprimir la transición, asegúrese también de usar GoBack o GoForward para navegar a la página correcta en el historial de navegación. NavigateToType también se admite, pero la pila de reenvío se borrará cuando se use.