Frame.Navigate Метод

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

Параметры

Возвращаемое значение

falseЗначение , trueесли обработчик событий NavigationFailed имеет значение Handledtrue; в противном случае . Дополнительные сведения см. в примечаниях.

Реализации

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

Параметры

Возвращаемое значение

falseЗначение , trueесли обработчик событий NavigationFailed имеет значение Handledtrue; в противном случае . Дополнительные сведения см. в примечаниях.

Атрибуты

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

Параметры

Возвращаемое значение

falseЗначение , trueесли обработчик событий NavigationFailed имеет значение Handledtrue; в противном случае . Дополнительные сведения см. в примечаниях.

Атрибуты

OverloadAttribute

Примеры

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

Комментарии

Событие NavigationFailed обрабатывается для реагирования на сбой навигации. Вы можете обработать сбой непосредственно в обработчике событий или задать свойство true и использовать возвращаемое значение метода Navigate для реагирования на сбой.

Значения параметров

С помощью GetNavigationState можно сериализовать состояние кадра и SetNavigationState , чтобы восстановить его позже. Чтобы включить сериализацию состояния кадра с помощью этих методов, необходимо использовать только базовые типы для навигации parameter, такие как строка, символ, числовые и типы GUID . GetNavigationState В противном случае вызовет исключение.

Значение может иметь сложный тип, parameter если вы не используете GetNavigationState. Однако для предотвращения избыточного использования памяти, вызванного стеком parameterнавигации кадра, следует использовать только базовые типы. Предпочтительный подход заключается в том, чтобы не передавать фактический объект, а передавать идентификатор, который можно использовать для поиска объекта на целевой странице. Например, вместо передачи Customer объекта передайте ссылку на нее CustomerID, а затем выполните поиск Customer после завершения навигации.

См. также раздел

• Page
• NavigationFailed
• Основы проектирования навигации