Frame.Navigate 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

오버로드

Navigate(TypeName)	프레임이 지정된 페이지로 표시되는 콘텐츠를 로드하도록 합니다.
Navigate(TypeName, Object)	프레임이 지정된 페이지로 표시되는 콘텐츠를 로드하도록 하며, 탐색 대상에서 해석할 매개 변수도 전달합니다.
Navigate(TypeName, Object, NavigationTransitionInfo)	프레임이 지정된 페이지 파생 데이터 형식으로 표시되는 콘텐츠를 로드하도록 하고, 탐색 대상에서 해석할 매개 변수와 사용할 애니메이션 전환을 나타내는 값을 전달합니다.

Navigate(TypeName)

프레임이 지정된 페이지로 표시되는 콘텐츠를 로드하도록 합니다.

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

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 C++용 TypeName 도우미 구조체로 지정됩니다.

반환

Boolean

bool

falseNavigationFailed 이벤트 처리기가 Handled를 로 설정하면 이고true, true그렇지 않으면 입니다. 자세한 내용은 비고를 참조하세요.

구현

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

Navigate(TypeName, Object)

프레임이 지정된 페이지로 표시되는 콘텐츠를 로드하도록 하며, 탐색 대상에서 해석할 매개 변수도 전달합니다.

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

매개 변수

sourcePageType

TypeName Type

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 C++용 TypeName 도우미 구조체로 지정됩니다.

parameter

Object

Platform::Object

IInspectable

대상 페이지에 전달할 탐색 매개 변수입니다.

반환

Boolean

bool

falseNavigationFailed 이벤트 처리기가 Handled를 로 설정하면 이고true, true그렇지 않으면 입니다. 자세한 내용은 비고를 참조하세요.

특성

OverloadAttribute

Navigate(TypeName, Object, NavigationTransitionInfo)

프레임이 지정된 페이지 파생 데이터 형식으로 표시되는 콘텐츠를 로드하도록 하고, 탐색 대상에서 해석할 매개 변수와 사용할 애니메이션 전환을 나타내는 값을 전달합니다.

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

매개 변수

sourcePageType

TypeName Type

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 C++용 TypeName 도우미 구조체로 지정됩니다.

parameter

Object

Platform::Object

IInspectable

대상 페이지에 전달할 탐색 매개 변수입니다. GetNavigationState를 사용하여 매개 변수 serialization을 지원하려면 기본 형식(문자열, 문자, 숫자 또는 GUID)이 있어야 합니다.

infoOverride

NavigationTransitionInfo

애니메이션 전환에 대한 정보입니다.

반환

Boolean

bool

falseNavigationFailed 이벤트 처리기가 Handled를 로 설정하면 이고true, true그렇지 않으면 입니다. 자세한 내용은 비고를 참조하세요.

특성

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 이벤트를 처리합니다. 이벤트 처리기에서 직접 오류를 처리하거나 NavigationFailedEventArgs.Handled 속성을 true 로 설정하고 Navigate 메서드 반환 값을 사용하여 실패에 응답할 수 있습니다.

매개 변수 값

GetNavigationState를 사용하여 프레임의 상태를 직렬화하고 SetNavigationState를 사용하여 나중에 복원할 수 있습니다. 이러한 메서드를 사용하여 프레임 상태 직렬화를 사용하도록 설정하려면 문자열, 문자, 숫자 및 GUID 형식과 같은 탐색 parameter에 대한 기본 형식만 사용해야 합니다. 그렇지 않으면 는 GetNavigationState 예외를 throw합니다.

parameterGetNavigationState를 사용하지 않는 경우 값에 복합 형식이 있을 수 있습니다. 그러나 에 대한 참조 parameter를 포함하는 프레임의 탐색 스택으로 인한 과도한 메모리 사용을 방지하기 위해 기본 형식만 사용해야 합니다. 기본 방법은 실제 개체를 전달하지 않고 대상 방문 페이지에서 개체를 조회하는 데 사용할 수 있는 식별자를 전달하는 것입니다. 예를 들어 개체를 Customer 전달하는 대신 에 대한 참조를 CustomerID전달한 다음 탐색이 완료된 Customer 후 를 조회합니다.

팁

Microsoft .NET 언어(C# 또는 Microsoft Visual Basic)를 사용하여 프로그래밍하는 경우 TypeName 형식은 System.Type으로 프로젝트합니다. C#을 사용하여 프로그래밍할 때는 연산자를 사용하여 형식의 typeofSystem.Type 에 대한 참조를 가져오는 것이 일반적입니다. Microsoft Visual Basic에서 을 사용합니다 GetType. C++/WinRT를 사용하는 경우 도우미 함수를 winrt::xaml_typename<T>() 사용하여 개체를 TypeName 만들 수 있습니다. 자세한 내용 및 코드 예제 는 winrt::xaml_typename 함수 템플릿 을 참조하세요.

추가 정보

• Page
• NavigationFailed
• 탐색 디자인 기본 사항