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

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

Implémente

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

Retours

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

Attributs

OverloadAttribute

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

Retours

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.

Voir aussi

• Page
• NavigationFailed
• Concepts de base de la conception de navigation