Frame.Navigate Méthode

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

Retours

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

Implémente

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.

Voir aussi

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• 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

Retours

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

Voir aussi

• Page
• Navigate(TypeName)
• Navigation

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

Retours

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

• Navigate(TypeName, Object)
• Navigate(TypeName)
• Navigation