Frame.Navigate メソッド

定義

名前空間:

Microsoft.UI.Xaml.Controls

オーバーロード

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

Navigate(TypeName)

指定した Page で表されるコンテンツを 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

移動先のページ。部分クラス型への型参照として指定されます。 (型参照は 、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)

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

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)

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

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

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