Frame.Navigate メソッド

定義

名前空間:

Microsoft.UI.Xaml.Controls

オーバーロード

Navigate(TypeName)	指定した ページで表されるコンテンツを読み込む フレーム を指定します。
Navigate(TypeName, Object)	指定した ページで表されるコンテンツを読み込む フレーム を作成し、ナビゲーションのターゲットによって解釈されるパラメーターも渡します。
Navigate(TypeName, Object, NavigationTransitionInfo)	Frame が、指定した Page-derived データ型で表されるコンテンツを読み込みます。また、ナビゲーションのターゲットによって解釈されるパラメーターと、使用するアニメーション化された遷移を示す値も渡します。

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

NavigationFailed イベント ハンドラーが処理済み に設定した場合に します。それ以外の場合は、。 詳細については、「解説」を参照してください。

実装

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

NavigationFailed イベント ハンドラーが処理済み に設定した場合に します。それ以外の場合は、。 詳細については、「解説」を参照してください。

属性

OverloadAttribute

Navigate(TypeName, Object, NavigationTransitionInfo)

Frame が、指定した Page-derived データ型で表されるコンテンツを読み込みます。また、ナビゲーションのターゲットによって解釈されるパラメーターと、使用するアニメーション化された遷移を示す値も渡します。

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を使用してパラメーターのシリアル化をサポートするには、基本型 (文字列、文字、数値、または GUID) 必要があります。

infoOverride

NavigationTransitionInfo

アニメーションの切り替えに関する情報。

戻り値

Boolean

bool

NavigationFailed イベント ハンドラーが処理済み に設定した場合に します。それ以外の場合は、。 詳細については、「解説」を参照してください。

属性

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 を して後で復元できます。 これらのメソッドを使用してフレーム状態のシリアル化を有効にするには、ナビゲーション parameterの基本型 (文字列、文字、数値、GUID 型など) のみを使用する必要があります。 それ以外の場合、GetNavigationState は例外をスローします。

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
• ナビゲーションデザインの基本