다음을 통해 공유

Frame.Navigate 메서드

  • 참조

정의

네임스페이스:
Windows.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

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. 페이지 파생 데이터 형식이어야 합니다. 그렇지 않으면 예외가 throw됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 Visual C++ 구성 요소 확장(C++/CX)에 대한 TypeName 도우미 구조체로 지정됩니다.

반환

Boolean

bool

NavigationFailed 이벤트 처리기가 Handled를 true로 설정한 경우 false입니다. 그렇지 않으면 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 를 사용하여 앱이 일시 중단되면 프레임 상태를 직렬화합니다. Visual Studio 템플릿에서 생성된 클래스를 사용하여 SuspensionManager 앱 코드에서 직접 또는 간접적으로 이 작업을 수행할 수 있습니다. GetNavigationState를 사용하여 프레임 상태 serialization을 사용하도록 설정하려면 문자열, 문자, 숫자 및 GUID 형식과 같은 탐색 매개 변수에 대한 기본 형식만 사용해야 합니다. 그렇지 않으면 GetNavigationState 는 앱이 일시 중단될 때 예외를 throw합니다. 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)

편집

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

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

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. 페이지 파생 데이터 형식이어야 합니다. 그렇지 않으면 예외가 throw됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 Visual C++ 구성 요소 확장(C++/CX)에 대한 TypeName 도우미 구조체로 지정됩니다.

parameter
Object

Platform::Object

IInspectable

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

반환

Boolean

bool

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

추가 정보

적용 대상

Navigate(TypeName, Object, NavigationTransitionInfo)

편집

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

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

탐색할 페이지로, 부분 클래스 형식에 대한 형식 참조로 지정됩니다. 페이지 파생 데이터 형식이어야 합니다. 그렇지 않으면 예외가 throw됩니다. (형식 참조는 Microsoft .NET용 System.Type 또는 Visual C++ 구성 요소 확장(C++/CX)에 대한 TypeName 도우미 구조체로 지정됩니다.

parameter
Object

Platform::Object

IInspectable

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

infoOverride
NavigationTransitionInfo

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

반환

Boolean

bool

NavigationFailed 이벤트 처리기가 Handled를 true로 설정한 경우 false입니다. 그렇지 않으면 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());

추가 정보

적용 대상