Frame.Navigate 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

오버로드

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

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

반환

Boolean

bool

NavigationFailed 이벤트 처리기가 Handledtrue;로 설정했는지 false. 그렇지 않으면 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)

Frame 지정된 Page나타내는 콘텐츠를 로드하고 탐색 대상에서 해석할 매개 변수를 전달합니다.

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

NavigationFailed 이벤트 처리기가 Handledtrue;로 설정했는지 false. 그렇지 않으면 true. 자세한 내용은 비고를 참조하세요.

특성

OverloadAttribute

Navigate(TypeName, Object, NavigationTransitionInfo)

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

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

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

infoOverride

NavigationTransitionInfo

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

반환

Boolean

bool

NavigationFailed 이벤트 처리기가 Handledtrue;로 설정했는지 false. 그렇지 않으면 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 사용하여 프레임의 상태를 serialize하고 SetNavigationState 나중에 복원할 수 있습니다. 이러한 메서드를 사용하여 프레임 상태 serialization을 사용하도록 설정하려면 문자열, 문자, 숫자 및 GUID 형식과 같은 탐색 parameter기본 형식만 사용해야 합니다. 그렇지 않으면 GetNavigationState 예외를 throw합니다.

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

팁

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

추가 정보

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