Frame.Navigate Метод

Определение

Перегрузки

Navigate(TypeName)

Вызывает загрузку frame содержимого, представленного указанным типом данных, производным от страницы.

Navigate(TypeName, Object)

Заставляет frame загружать содержимое, представленное указанным типом данных, производным от страницы, а также передает параметр для интерпретации целевым объектом навигации.

Navigate(TypeName, Object, NavigationTransitionInfo)

Заставляет frame загружать содержимое, представленное указанным типом данных, производным от страницы, а также передает параметр для интерпретации целевым объектом навигации и значение, указывающее анимированный переход к использованию.

Navigate(TypeName)

Вызывает загрузку frame содержимого, представленного указанным типом данных, производным от страницы.

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

Параметры

sourcePageType
TypeName Type

Страница для перехода, указанная в качестве ссылки на тип своего разделяемого типа класса. Должен быть типом данных, производным от страницы; В противном случае возникает исключение. (Ссылка на тип предоставляется как System.Type для Microsoft .NET или вспомогательная структуру TypeName для расширений компонентов Visual C++ (C++/CX)).

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

Boolean

bool

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

Реализации

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

Комментарии

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

Приложения обычно используют GetNavigationState для сериализации состояния кадра при приостановке приложения. Это можно сделать непосредственно в коде приложения или косвенно с помощью класса, созданного SuspensionManager шаблонами Visual Studio. Чтобы включить сериализацию состояния кадра с помощью GetNavigationState, необходимо использовать только базовые типы для параметра навигации, такие как string, char, numeric и GUID . В противном случае GetNavigationState вызовет исключение при приостановке приложения. Параметр может иметь другие типы, если вы не используете GetNavigationState.

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

Совет

При программировании на языке Microsoft .NET (C# или Microsoft Visual Basic) тип TypeName проектируются как System.Type. При программировании на C# оператор typeof часто используется для получения ссылок на System.Type типа. В Microsoft Visual Basic используйте GetType. Если вы используете расширения компонентов Visual C++ (C++/CX), где необходимо создать вспомогательную структуру TypeName , можно использовать расширение компонента typeid.

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

Применяется к

Navigate(TypeName, Object)

Заставляет frame загружать содержимое, представленное указанным типом данных, производным от страницы, а также передает параметр для интерпретации целевым объектом навигации.

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

Параметры

sourcePageType
TypeName Type

Страница для перехода, указанная в качестве ссылки на тип своего разделяемого типа класса. Должен быть типом данных, производным от страницы; В противном случае возникает исключение. (Ссылка на тип предоставляется как System.Type для Microsoft .NET или вспомогательная структуру TypeName для расширений компонентов Visual C++ (C++/CX)).

parameter
Object

Platform::Object

IInspectable

Параметр навигации для передачи на целевую страницу; должен иметь базовый тип (string, char, numeric или GUID) для поддержки сериализации параметров с помощью GetNavigationState.

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

Boolean

bool

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

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

Применяется к

Navigate(TypeName, Object, NavigationTransitionInfo)

Заставляет frame загружать содержимое, представленное указанным типом данных, производным от страницы, а также передает параметр для интерпретации целевым объектом навигации и значение, указывающее анимированный переход к использованию.

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

Параметры

sourcePageType
TypeName Type

Страница для перехода, указанная в качестве ссылки на тип своего разделяемого типа класса. Должен быть типом данных, производным от страницы; В противном случае возникает исключение. (Ссылка на тип предоставляется как System.Type для Microsoft .NET или вспомогательная структуру TypeName для расширений компонентов Visual C++ (C++/CX)).

parameter
Object

Platform::Object

IInspectable

Параметр навигации для передачи на целевую страницу; должен иметь базовый тип (string, char, numeric или GUID) для поддержки сериализации параметров с помощью GetNavigationState.

infoOverride
NavigationTransitionInfo

Сведения о анимированном переходе.

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

Boolean

bool

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

Примеры

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

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

Применяется к