Frame.Navigate メソッド

定義

名前空間:

Windows.UI.Xaml.Controls

オーバーロード

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

Navigate(TypeName)

指定したページ派生データ型で表されるコンテンツを Frame に読み込みます。

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 for Microsoft .NET、または 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 を使用してフレーム状態のシリアル化を有効にするには、ナビゲーション パラメーターに基本型 (string、char、numeric、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 コンポーネント拡張機能を使用できます。

こちらもご覧ください

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• ナビゲーション

Navigate(TypeName, Object)

指定したページ派生データ型で表されるコンテンツを Frame に読み込み、ナビゲーションのターゲットによって解釈されるパラメーターも渡します。

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 for Microsoft .NET、または Visual C++ コンポーネント拡張機能 (C++/CX) の TypeName ヘルパー構造体として指定されます)。

parameter

Object

Platform::Object

IInspectable

ターゲット ページに渡すナビゲーション パラメーター。GetNavigationState を使用したパラメーターのシリアル化をサポートするには、基本型 (string、char、numeric、または GUID) が必要です。

戻り値

Boolean

bool

NavigationFailed イベント ハンドラーで Handled が true に設定されている場合は false。それ以外の場合は true。 詳細については、「解説」を参照してください。

こちらもご覧ください

• Page
• Navigate(TypeName)
• ナビゲーション

Navigate(TypeName, Object, NavigationTransitionInfo)

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

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 for Microsoft .NET、または Visual C++ コンポーネント拡張機能 (C++/CX) の TypeName ヘルパー構造体として指定されます)。

parameter

Object

Platform::Object

IInspectable

ターゲット ページに渡すナビゲーション パラメーター。GetNavigationState を使用したパラメーターのシリアル化をサポートするには、基本型 (string、char、numeric、または 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());

こちらもご覧ください

• Navigate(TypeName, Object)
• Navigate(TypeName)
• ナビゲーション