Frame.Navigate Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.UI.Xaml.Controls

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)

Editar

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

sourcePageType
TypeName Type

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

Boolean

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

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

Se aplica a

Navigate(TypeName, Object)

Editar

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

sourcePageType
TypeName Type

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

Boolean

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
OverloadAttribute

Se aplica a

Navigate(TypeName, Object, NavigationTransitionInfo)

Editar

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

sourcePageType
TypeName Type

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

Boolean

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
OverloadAttribute

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 trueNavigationFailedEventArgs.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 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 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.

Consulte también

Se aplica a