Frame.Navigate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
Navigate(TypeName) |
Hace que frame cargue el contenido representado por la página especificada. |
Navigate(TypeName, Object) |
Hace que frame cargue el contenido representado por la página especificada, pasando también un parámetro que se interpretará mediante el destino de la navegación. |
Navigate(TypeName, Object, NavigationTransitionInfo) |
Hace que frame cargue el contenido representado por el tipo de datos derivado de page especificado, pasando también un parámetro que se interpretará mediante el destino de la navegación y un valor que indica la transición animada que se va a usar. |
Navigate(TypeName)
Hace que frame cargue el contenido representado por la página especificada.
public:
virtual bool Navigate(TypeName sourcePageType) = Navigate;
bool Navigate(TypeName const& sourcePageType);
public bool Navigate(System.Type sourcePageType);
function navigate(sourcePageType)
Public Function Navigate (sourcePageType As Type) As Boolean
Parámetros
Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para C++).
Devoluciones
bool
false
si un controlador de eventos NavigationFailed ha establecido Handled entrue
; de lo contrario, true
. Consulta Comentarios para obtener más información.
Implementaciones
Se aplica a
Navigate(TypeName, Object)
Hace que frame cargue el contenido representado por la página especificada, pasando también un parámetro que se interpretará mediante el destino de la navegación.
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter) = Navigate;
/// [Windows.Foundation.Metadata.Overload("Navigate")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);
[Windows.Foundation.Metadata.Overload("Navigate")]
public bool Navigate(System.Type sourcePageType, object parameter);
function navigate(sourcePageType, parameter)
Public Function Navigate (sourcePageType As Type, parameter As Object) As Boolean
Parámetros
Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para C++).
- parameter
-
Object
Platform::Object
IInspectable
Parámetro de navegación que se va a pasar a la página de destino.
Devoluciones
bool
false
si un controlador de eventos NavigationFailed ha establecido Handled entrue
; de lo contrario, true
. Consulta Comentarios para obtener más información.
- Atributos
Se aplica a
Navigate(TypeName, Object, NavigationTransitionInfo)
Hace que frame cargue el contenido representado por el tipo de datos derivado de page especificado, pasando también un parámetro que se interpretará mediante el destino de la navegación y un valor que indica la transición animada que se va a usar.
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter, NavigationTransitionInfo ^ infoOverride) = Navigate;
/// [Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);
[Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
public bool Navigate(System.Type sourcePageType, object parameter, NavigationTransitionInfo infoOverride);
function navigate(sourcePageType, parameter, infoOverride)
Public Function Navigate (sourcePageType As Type, parameter As Object, infoOverride As NavigationTransitionInfo) As Boolean
Parámetros
Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para C++).
- parameter
-
Object
Platform::Object
IInspectable
Parámetro de navegación que se va a pasar a la página de destino; debe tener un tipo básico (cadena, char, numérico o GUID) para admitir la serialización de parámetros mediante GetNavigationState.
- infoOverride
- NavigationTransitionInfo
Información sobre la transición animada.
Devoluciones
bool
false
si un controlador de eventos NavigationFailed ha establecido Handled entrue
; de lo contrario, true
. Consulta Comentarios para obtener más información.
- Atributos
Ejemplos
<Frame x:Name="myFrame">
<Frame.ContentTransitions>
<TransitionCollection>
<NavigationThemeTransition />
</TransitionCollection>
</Frame.ContentTransitions>
</Frame>
// Play the default animation
myFrame.Navigate(typeof(Page2), null);
// Explicitly play the page refresh animation
myFrame.Navigate(typeof(Page2), null, new EntranceNavigationTransitionInfo());
// Play the drill in animation
myFrame.Navigate(typeof(Page2), null, new DrillInNavigationTransitionInfo());
// Suppress the default animation
myFrame.Navigate(typeof(Page2), null, new SuppressNavigationTransitionInfo());
Comentarios
El evento NavigationFailed se controla para responder a un error de navegación. Puede controlar el error directamente en el controlador de eventos, o bien puede establecer la propiedad true
NavigationFailedEventArgs.Handled en y usar el valor devuelto del método Navigate para responder al error.
Valores de parámetros
Puede usar GetNavigationState para serializar el estado del fotograma y SetNavigationState para restaurarlo más adelante. Para habilitar la serialización de estado de fotograma mediante estos métodos, solo debe usar tipos básicos para la navegación parameter
, como los tipos string, char, numeric y GUID . De lo contrario, GetNavigationState
producirá una excepción.
El parameter
valor puede tener un tipo complejo si no usa GetNavigationState. Sin embargo, todavía debe usar solo tipos básicos para evitar el exceso de uso de memoria causado por la pila de navegación del marco que contiene una referencia a .parameter
Un enfoque preferido es no pasar el objeto real, sino pasar un identificador que puede usar para buscar el objeto en la página de aterrizaje de destino. Por ejemplo, en lugar de pasar un Customer
objeto, pase una referencia a CustomerID
y busque una Customer
vez completada la navegación.
Sugerencia
Si va a programar con un lenguaje Microsoft .NET (C# o Microsoft Visual Basic), typeName escribe proyectos como System.Type. Al programar con C#, es habitual usar el typeof
operador para obtener referencias al System.Type de un tipo. En Microsoft Visual Basic, use GetType
. Si usa C++/WinRT , puede usar la winrt::xaml_typename<T>()
función auxiliar para crear un TypeName
objeto. Consulte winrt::xaml_typename plantilla de función para obtener más detalles y un ejemplo de código.