Frame.Navigate Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.UI.Xaml.Controls

Sobrecargas

Navigate(TypeName)

Hace que el frame de cargue el contenido representado por el page especificado.
Navigate(TypeName, Object)

Hace que el frame de cargue el contenido representado por el Page especificado, pasando también un parámetro que el destino de la navegación interprete.
Navigate(TypeName, Object, NavigationTransitionInfo)

Hace que el frame de cargue el contenido representado por el page especificadotipo de datos derivado, pasando también un parámetro para que lo interprete 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 el frame de cargue el contenido representado por el 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. (Se proporciona una referencia de tipo como System.Type para Microsoft .NET o un typeName de estructura auxiliar para C++).

Devoluciones

Boolean

bool

si un controlador de eventos NavigationFailed ha establecido controlado en ; de lo contrario, . 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 el frame de cargue el contenido representado por el Page especificado, pasando también un parámetro que el destino de la navegación interprete.

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 un typeName de estructura auxiliar 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

si un controlador de eventos NavigationFailed ha establecido controlado en ; de lo contrario, . Consulta Comentarios para obtener más información.

Atributos
OverloadAttribute

Se aplica a

Navigate(TypeName, Object, NavigationTransitionInfo)

Editar

Hace que el frame de cargue el contenido representado por el page especificadotipo de datos derivado, pasando también un parámetro para que lo interprete 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 un typeName de estructura auxiliar 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 (string, char, numeric o GUID) para admitir la serialización de parámetros mediante GetNavigationState.

infoOverride
NavigationTransitionInfo

Información sobre la transición animada.

Devoluciones

Boolean

bool

si un controlador de eventos NavigationFailed ha establecido controlado en ; de lo contrario, . 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

Controla 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 y usar el valor devuelto del método navigate para responder al error.

Valores de parámetro

Puede usar GetNavigationState para serializar el estado del marco y SetNavigationState para restaurarlo más adelante. Para habilitar la serialización de estado de marco mediante estos métodos, solo debe usar tipos básicos para el parameterde navegación, como los tipos string, char, numeric y GUID. De lo contrario, GetNavigationState producirá una excepción.

El valor de parameter puede tener un tipo complejo si no usa GetNavigationState. Sin embargo, todavía debe usar solo tipos básicos para evitar el uso excesivo de memoria causado por la pila de navegación del marco que contiene una referencia a la 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 objeto Customer, pase una referencia al CustomerIDy busque el Customer una vez completada la navegación.

Propina

Si va a programar con un lenguaje Microsoft .NET (C# o Microsoft Visual Basic), el TypeName proyectos de tipo 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 C++/WinRT, puede usar la función auxiliar de winrt::xaml_typename<T>() para crear un objeto TypeName. Consulte plantilla de función winrt::xaml_typename para obtener más detalles y un ejemplo de código.

Consulte también

Se aplica a