Frame.Navigate(TypeName, Object, NavigationTransitionInfo) Method

Provoca que Frame cargue el contenido representado por el tipo de datos derivado de Page especificado además de transferir un parámetro para ser interpretado por el destino de navegación y un valor que indica la transición animada que se debe utilizar.

Sintaxis


public bool Navigate(
  Type sourcePageType, 
  object parameter, 
  NavigationTransitionInfo infoOverride
)

Parámetros

sourcePageType

Tipo: System.Type [.NET] | TypeName [C++]

El tipo de datos de contenido que se va a cargar.

parameter

Tipo: System.Object [.NET] | Platform::Object [C++]

Parámetro de navegación para se va a pasar a la página de destino; debe tener un tipo básico (string, char, numeric o GUID) para ser compatible con la serialización de parámetros mediante GetNavigationState.

infoOverride

Tipo: NavigationTransitionInfo

Información sobre la transición animada.

Valor devuelto

Tipo: System.Boolean [.NET] | Platform::Boolean [C++]

false si un controlador del evento NavigationFailed estableció la propiedad Handled como true; de lo contrario, true. Vea la sección Comentarios para obtener más información.

Comentarios

Actualmente, debe controlar el evento NavigationFailed para responder a un error de navegación. Puede controlar el error directamente en el controlador de eventos, o puede establecer la propiedad NavigationFailedEventArgs.Handled en true y utilizar el valor devuelto del método Navigate para responder al error.

Las aplicaciones suelen usar el método GetNavigationState para serializar el estado del marco cuando la aplicación entra en suspensión. Puede hacerlo directamente en el código de la aplicación o indirectamente utilizando la clase SuspensionManager generada por las plantillas de aplicación de Visual Studio. Para habilitar la serialización del estado del cuadro mediante GetNavigationState, debe usar únicamente los tipos básicos para el parámetro de navegación, como string, char, numeric y GUID. De lo contrario, GetNavigationState producirá una excepción cuando la aplicación entra en suspensión. El parámetro puede tener otros tipos si no se utiliza GetNavigationState.

El valor del parámetro puede tener un tipo complejo si no se utiliza GetNavigationState. Sin embargo, aún debe utilizar sólo tipos básicos para evitar exceso de utilización de memoria producida por la pila de navegación del marco que contiene una referencia al parámetro.

Sugerencia  Si está programando utilizando un lenguaje de Microsoft .NET (C# o Microsoft Visual Basic), el tipo TypeName se proyecta como System.Type. Al programar con C#, lo habitual es utilizar el operador typeof para obtener referencias al System.Type de un tipo. En Visual Basic, utilice GetType.

Requisitos

Cliente mínimo admitido

Windows 8.1

Servidor mínimo admitido

Windows Server 2012 R2

Espacio de nombres

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadatos

Windows.winmd

Vea también

Frame
Navigate(TypeName, Object)
Navigate(TypeName)

 

 

Mostrar:
© 2015 Microsoft