Frame.Navigate Метод

Определение

Перегрузки

Navigate(TypeName)

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

Navigate(TypeName, Object)

Вызывает Frame загрузку содержимого, представленного указанным Page, а также передает параметр, интерпретируемый целевым объектом навигации.

Navigate(TypeName, Object, NavigationTransitionInfo)

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

Navigate(TypeName)

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

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 обработчик событий имеет Handled значение 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необходимо использовать только базовые типы для параметра навигации, например строковые, char, числовые и 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 загрузку содержимого, представленного указанным Page, а также передает параметр, интерпретируемый целевым объектом навигации.

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

IInspectable

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

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

Boolean

bool

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

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

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

Navigate(TypeName, Object, NavigationTransitionInfo)

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

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

IInspectable

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

infoOverride
NavigationTransitionInfo

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

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

Boolean

bool

Значение false , если NavigationFailed обработчик событий имеет Handled значение 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());

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

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