Frame.Navigate Método

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Sobrecargas

Navigate(TypeName)	Hace que frame cargue el contenido representado por el tipo de datos derivado de page especificado.
Navigate(TypeName, Object)	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.
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 el tipo de datos derivado de page especificado.

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

sourcePageType

TypeName Type

Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. Debe ser un tipo de datos derivado de page; de lo contrario, se produce una excepción. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para extensiones de componentes de Visual C++ (C++/CX)).

Devoluciones

Boolean

bool

false si un controlador de eventos NavigationFailed ha establecido Handled entrue; de lo contrario, es true. Consulta Comentarios para obtener más información.

Implementaciones

M:Windows.UI.Xaml.Controls.INavigate.Navigate(Windows.UI.Xaml.Interop.TypeName) M:Windows.UI.Xaml.Controls.INavigate.Navigate(System.Type)

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 NavigationFailedEventArgs.Handled en true y usar el valor devuelto del método Navigate para responder al error.

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

El valor del parámetro 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 al parámetro . 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 CustomerIDy 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 operador typeof para obtener referencias al system.Type de un tipo. En Microsoft Visual Basic, use GetType. Si usa extensiones de componentes de Visual C++ (C++/CX), donde deberá crear una estructura auxiliar TypeName , puede usar la extensión de componente typeid.

Consulte también

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• Navegación

Navigate(TypeName, Object)

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.

public:
 virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter) = Navigate;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);

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

sourcePageType

TypeName Type

Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. Debe ser un tipo de datos derivado de page; de lo contrario, se produce una excepción. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para extensiones de componentes de Visual C++ (C++/CX)).

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.

Devoluciones

Boolean

bool

false si un controlador de eventos NavigationFailed ha establecido Handled entrue; de lo contrario, es true. Consulta Comentarios para obtener más información.

Consulte también

• Page
• Navigate(TypeName)
• 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.

public:
 virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter, NavigationTransitionInfo ^ infoOverride) = Navigate;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);

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

sourcePageType

TypeName Type

Página a la que se va a navegar, especificada como referencia de tipo a su tipo de clase parcial. Debe ser un tipo de datos derivado de page; de lo contrario, se produce una excepción. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o una estructura auxiliar TypeName para extensiones de componentes de Visual C++ (C++/CX)).

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

Boolean

bool

false si un controlador de eventos NavigationFailed ha establecido Handled entrue; de lo contrario, es true. Consulta Comentarios para obtener más información.

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());

Consulte también

• Navigate(TypeName, Object)
• Navigate(TypeName)
• Navegación