Partager via

Frame.Navigate Méthode

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml.Controls

Surcharges

Navigate(TypeName)

Provoque le chargement du contenu du frame par lepage spécifié.
Navigate(TypeName, Object)

Provoque le chargement du contenu Frame représenté par l'page spécifié, en passant également un paramètre à interpréter par la cible de la navigation.
Navigate(TypeName, Object, NavigationTransitionInfo)

Provoque le chargement du contenu Frame représenté par le type de donnéesPage spécifié, en passant également un paramètre à interpréter par la cible de la navigation et une valeur indiquant la transition animée à utiliser.

Navigate(TypeName)

Modifier

Provoque le chargement du contenu du frame par lepage spécifié.

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

Paramètres

sourcePageType
TypeName Type

Page vers laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. (Une référence de type est donnée en tant que System.Type pour Microsoft .NET, ou un TypeName struct d’assistance pour C++).

Retours

Boolean

bool

si un gestionnaire d’événements NavigationFailed de géré a la valeur ; sinon, . Pour plus d’informations, consultez les remarques.

Implémente

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

S’applique à

Navigate(TypeName, Object)

Modifier

Provoque le chargement du contenu Frame représenté par l'page spécifié, en passant également un paramètre à interpréter par la cible de la navigation.

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

Paramètres

sourcePageType
TypeName Type

Page vers laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. (Une référence de type est donnée en tant que System.Type pour Microsoft .NET, ou un TypeName struct d’assistance pour C++).

parameter
Object

Platform::Object

IInspectable

Paramètre de navigation à passer à la page cible.

Retours

Boolean

bool

si un gestionnaire d’événements NavigationFailed de géré a la valeur ; sinon, . Pour plus d’informations, consultez les remarques.

Attributs
OverloadAttribute

S’applique à

Navigate(TypeName, Object, NavigationTransitionInfo)

Modifier

Provoque le chargement du contenu Frame représenté par le type de donnéesPage spécifié, en passant également un paramètre à interpréter par la cible de la navigation et une valeur indiquant la transition animée à utiliser.

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

Paramètres

sourcePageType
TypeName Type

Page vers laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. (Une référence de type est donnée en tant que System.Type pour Microsoft .NET, ou un TypeName struct d’assistance pour C++).

parameter
Object

Platform::Object

IInspectable

Paramètre de navigation à passer à la page cible ; doit avoir un type de base (chaîne, char, numérique ou GUID) pour prendre en charge la sérialisation des paramètres à l’aide de GetNavigationState.

infoOverride
NavigationTransitionInfo

Informations sur la transition animée.

Retours

Boolean

bool

si un gestionnaire d’événements NavigationFailed de géré a la valeur ; sinon, . Pour plus d’informations, consultez les remarques.

Attributs
OverloadAttribute

Exemples

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

Remarques

Vous gérez l’événement NavigationFailed pour répondre à l’échec de navigation. Vous pouvez gérer l’échec directement dans le gestionnaire d’événements, ou vous pouvez définir la propriété NavigationFailedEventArgs.Handled sur true et utiliser la valeur de retour de méthode Navigate pour répondre à l’échec.

Valeurs des paramètres

Vous pouvez utiliser GetNavigationState pour sérialiser l’état de l’image et SetNavigationState pour la restaurer ultérieurement. Pour activer la sérialisation d’état frame à l’aide de ces méthodes, vous devez utiliser uniquement des types de base pour les parameterde navigation, tels que la chaîne, le char, le numérique et GUID types. Sinon, GetNavigationState lève une exception.

La valeur parameter peut avoir un type complexe si vous n’utilisez pas GetNavigationState. Toutefois, vous devez toujours utiliser uniquement des types de base afin d’éviter l’utilisation excessive de la mémoire causée par la pile de navigation du frame contenant une référence au parameter. Une approche préférée consiste à ne pas passer l’objet réel, mais à la place, passez un identificateur que vous pouvez utiliser pour rechercher l’objet dans la page d’accueil cible. Par exemple, au lieu de passer un objet Customer, passez une référence au CustomerID, puis recherchez le Customer une fois la navigation terminée.

Pourboire

Si vous programmez à l’aide d’un langage Microsoft .NET (C# ou Microsoft Visual Basic), les projets de type TypeName en tant que System.Type. Lors de la programmation à l’aide de C#, il est courant d’utiliser l’opérateur typeof pour obtenir des références au System.Type d’un type. Dans Microsoft Visual Basic, utilisez GetType. Si vous utilisez C++/WinRT vous pouvez utiliser la fonction d’assistance winrt::xaml_typename<T>() pour créer un objet TypeName. Consultez modèle de fonction winrt ::xaml_typename pour plus d’informations et un exemple de code.

Voir aussi

S’applique à