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

false si un gestionnaire d’événements NavigationFailed a défini Handled sur true; sinon, true. 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

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

Valeurs de paramètres

Vous pouvez utiliser GetNavigationState pour sérialiser l’état du frame et SetNavigationState pour le restaurer ultérieurement. Pour activer la sérialisation de l’état d’image à l’aide de ces méthodes, vous devez utiliser uniquement des types de base pour la navigation parameter, comme les types chaîne, char, numérique et GUID . Sinon, 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 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 Customer objet, passez une référence à l’objet CustomerID, puis recherchez l’après Customer la fin de la navigation.

Voir aussi

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