Frame.Navigate Méthode

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml.Controls

Surcharges

Navigate(TypeName)

Provoque le chargement du contenu frame représenté par la page spécifiée.
Navigate(TypeName, Object)

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

Entraîne le chargement du contenu frame représenté par le type de données dérivé de la page 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 frame représenté par la page spécifiée.

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 partiel. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName pour C++).

Retours

Boolean

bool

false si un gestionnaire d’événements NavigationFailed a défini Handled sur true; sinon, true. Pour plus d’informations, consultez 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 la page spécifiée, 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 partiel. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName pour C++).

parameter
Object

Platform::Object

IInspectable

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

Retours

Boolean

bool

false si un gestionnaire d’événements NavigationFailed a défini Handled sur true; sinon, true. Pour plus d’informations, consultez Remarques.

Attributs
OverloadAttribute

S’applique à

Navigate(TypeName, Object, NavigationTransitionInfo)

Modifier

Entraîne le chargement du contenu frame représenté par le type de données dérivé de la page 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 partiel. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName 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

false si un gestionnaire d’événements NavigationFailed a défini Handled sur true; sinon, true. Pour plus d’informations, consultez 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 la méthode Navigate pour répondre à l’échec.

Valeurs de paramètres

Vous pouvez utiliser GetNavigationState pour sérialiser l’état de la trame et SetNavigationState pour la restaurer ultérieurement. Pour activer la sérialisation de l’état de trame à l’aide de ces méthodes, vous devez utiliser uniquement les types de base pour la navigation parameter, tels que les types string, char, numeric et GUID . Dans le cas contraire, GetNavigationState lève une exception.

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

Conseil

Si vous programmez à l’aide d’un langage Microsoft .NET (C# ou Microsoft Visual Basic), le type TypeName est projeté comme 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 à System.Type d’un type. Dans Microsoft Visual Basic, utilisez GetType. Si vous utilisez C++/WinRT , vous pouvez utiliser la winrt::xaml_typename<T>() fonction d’assistance pour créer un TypeName objet. Pour plus d’informations, consultez modèle de fonction winrt ::xaml_typename et un exemple de code.

Voir aussi

S’applique à