Frame.Navigate Méthode

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml.Controls

Surcharges

Navigate(TypeName)

Entraîne le chargement du contenu frame représenté par le type de données dérivé de page spécifié.
Navigate(TypeName, Object)

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

Entraîne le chargement du contenu frame représenté par le type de données dérivé de page 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 à laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. Doit être un type de données dérivé de page ; sinon, une exception est levée. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).

Retours

Boolean

bool

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

Implémente

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

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.

Les applications utilisent généralement GetNavigationState pour sérialiser l’état de la trame lorsque l’application s’interrompt. Vous pouvez le faire directement dans le code de votre application ou indirectement à l’aide de la SuspensionManager classe générée par les modèles Visual Studio. Pour activer la sérialisation de l’état de trame à l’aide de GetNavigationState, vous devez utiliser uniquement des types de base pour le paramètre de navigation, tels que les types string, char, numeric et GUID . Sinon , GetNavigationState lève une exception lors de la suspension de l’application. Le paramètre peut avoir d’autres types si vous n’utilisez pas GetNavigationState.

La valeur du paramètre peut avoir un type complexe si vous n’utilisez pas GetNavigationState. Toutefois, vous devez toujours utiliser uniquement les types de base afin d’éviter l’utilisation excessive de la mémoire causée par la pile de navigation de l’image contenant une référence au paramètre. Une approche recommandée consiste à ne pas passer l’objet réel, mais à 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 au System.Type d’un type. Dans Microsoft Visual Basic, utilisez GetType. Si vous utilisez des extensions de composant Visual C++ (C++/CX), où vous devez créer un struct d’assistance TypeName , vous pouvez utiliser l’extension de composant typeid.

Voir aussi

S’applique à

Navigate(TypeName, Object)

Modifier

Entraîne le chargement du contenu frame représenté par le type de données dérivé de 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;
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

Paramètres

sourcePageType
TypeName Type

Page à laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. Doit être un type de données dérivé de page ; sinon, une exception est levée. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).

parameter
Object

Platform::Object

IInspectable

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

Retours

Boolean

bool

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

Voir aussi

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

Paramètres

sourcePageType
TypeName Type

Page à laquelle accéder, spécifiée en tant que référence de type à son type de classe partielle. Doit être un type de données dérivé de page ; sinon, une exception est levée. (Une référence de type est donnée sous la forme System.Type pour Microsoft .NET, ou un struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).

parameter
Object

Platform::Object

IInspectable

Paramètre de navigation à passer à la page cible ; doit avoir un type de base (string, char, numeric 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 Notes.

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

Voir aussi

S’applique à