👩🏻‍🍳 🔈 🚴🏼 Prism開発者ガイド-パート8.1、ビューベースのナビゲーション 🉑 🛤️ 🚔

目次

はじめに
Prismアプリケーションの初期化
コンポーネント間の依存関係の管理
モジュラーアプリケーション開発
MVVMパターンの実装
高度なMVVMシナリオ
ユーザーインターフェイスの作成

ユーザーインターフェイスのガイドライン
ナビゲーション
ビューベースのナビゲーション
疎結合コンポーネント間の相互作用

ビューベースのナビゲーション

状態ベースのナビゲーションは、前述のシナリオでは役立ちますが、アプリケーション内のナビゲーションでは、あるビューを別のビューに置き換える必要がよくあります。 Prismでは、この種のナビゲーションは「 ビューベースのナビゲーション 」と呼ばれます。

アプリケーションの要件によっては、ナビゲーションプロセスが非常に複雑になる可能性があり、注意深い調整が必要です。以下に、ビューベースのナビゲーションを実装するときに発生する可能性のあるいくつかの課題を示します。

ナビゲーションの目的（ビューを追加または削除するためのコンテナー）は、ビューを追加または削除するときにナビゲーションをさまざまな方法で処理したり、さまざまな方法でナビゲーションプロセスを視覚化したりできます。多くの場合、ナビゲーションターゲットは通常のFrame

またはContentControl

であり、ビューはこれらのコントロール内に単に表示されます。ただし、ナビゲーションの目的がTabControl

やListBox

などの異なる種類のコントロールである多くのシナリオがあります。このような場合、ナビゲーションでは、既存のビューをアクティブ化または強調表示するか、新しいビューを追加する必要があります。
多くの場合、アプリケーションでは、ナビゲーションを実行するビューを何らかの方法で識別する必要があります。たとえば、Webアプリケーションでは、ナビゲートしているページはURIによって直接識別されます。クライアントアプリケーションでは、ビューはそのタイプの名前、リソースファイルの場所、または他の多くの方法で識別できます。疎結合モジュールで構成される複合アプリケーションでは、多くの場合、表現は別々のモジュールで定義されます。そのような場合、個々の表現は、モジュール間に追加の依存関係を作成せずに識別できる必要があります。
プレゼンテーションが特定されたら、その作成と初期化のプロセスを慎重に調整する必要があります。これは、MVVMパターンを使用する場合に特に重要です。この場合、ナビゲーション中にビューと対応するプレゼンテーションモデルを作成し、互いに関連付ける必要があります。 UnityやMEFなどの依存性注入コンテナーを使用している場合、ビューモデルやビューを作成するときに特別な構築メカニズムを使用する必要がある場合があります。
MVVMパターンを使用すると、アプリケーションUIをユーザーインタラクションロジックおよびビジネスロジックから分離できます。ただし、ナビゲーションプロセスはUIとアプリケーションロジックの両方をカバーできます。ユーザーはビュー内でナビゲーションを開始でき、その結果、ビューが更新されます。ただし、多くの場合、ビューモデルからナビゲーションを開始および調整する機能が必要になります。考慮すべき重要な考慮事項は、ビューとビューモデル間のナビゲーション動作を明確に区別する機能です。
アプリケーションは、適切に初期化するために、ビューにパラメーターまたはコンテキストを渡す必要がある場合がよくあります。たとえば、ユーザーがビューに移動して選択したクライアントに関する情報を編集する場合、クライアントのIDまたはデータをビューに転送して、正しい情報を表示する必要があります。
多くのアプリケーションでは、特定のビジネス要件が満たされるように、ナビゲーションを慎重に調整する必要があります。たとえば、別のビューに移動しようとしているときに、ユーザーが入力したデータの不正確さに関するポップアップメッセージが表示される場合があります。このプロセスには、以前のアイデアと新しいアイデアの調整が必要です。
最後に、最新のアプリケーションのほとんどでは、ユーザーは前または次のビューに移動できます。同様に、一部のアプリケーションは一連のビューまたはフォームを使用してワークフローを実装し、ユーザーがタスクを完了して1つのバッチで行われたすべての変更を送信する前にデータを追加または編集することで、前後にナビゲートできるようにします。そのようなシナリオでは、ナビゲーションシーケンスを保存、繰り返し、または事前定義するために、何らかの種類のログメカニズムが必要です。

Prismは、これらの問題を解決する方法に関するガイダンスを提供し、ナビゲーションをサポートするために地域メカニズムを拡張します。以下のセクションでは、Prismリージョンの概要と、ビューベースのナビゲーションをサポートするためにどのように拡張されているかを説明します。

地域概要プリズム

Prismリージョンは、複合アプリケーション（複数のモジュールで構成されるアプリケーション）の開発をサポートするように設計されており、ユーザーインターフェイスを疎結合で構築できます。リージョンを使用すると、アプリケーションUIのモジュールで定義されたビューを表示できます。モジュールは、ユーザーインターフェイスの完全な構造を知る必要はありません。これにより、モジュール自体に変更を加えることなく、UIアプリケーションのレイアウトを簡単に変更できます。

Prismリージョンは、ほとんどの場合、ビューが表示される名前付きのプレースホルダーです。以下に示すように、添付されたRegionName

プロパティを追加するだけで、任意のコントロールを領域として宣言できます。

 <ContentControl prism:RegionManager.RegionName="MainRegion" ... />

Region

として定義された各コントロールに対して、Prismは、 Region

自体を表すRegion

オブジェクトと、指定されたコントロール内のビューの位置とアクティブ化を制御するタスクを持つRegionAdapter

オブジェクト（リージョンアダプター）を作成します。 Prism Libraryは、ほとんどのSilverlightおよびWPFコントロールにRegionAdapter

実装を提供します。独自のRegionAdapter

を作成して、追加のコントロールをサポートしたり、特別な動作を実装したりできます。 RegionManager

クラス（領域マネージャー）は、アプリケーションのRegion

オブジェクトへのアクセスを提供します。

多くの場合、リージョンは、一度に1つのビューのみを表示できるContentControl

などの単純なコントロールにすることができます。また、 TabControl

やListBox

など、複数のビューを一度に表示できるコントロールの場合もあります。

リージョンアダプタは、そのリージョンに関連付けられたビューのリストを管理します。これらのビューの1つ以上は、そのコンテンツ表示戦略に従って領域コントロールに表示できます。ビューには、後で検索するために使用できる名前を割り当てることができます。リージョンアダプターは、そのリージョンでアクティブにするビューも制御します。アクティブは、現在強調表示されているビュー、または一番上のビューです。たとえば、 TabControl

では、選択したタブに表示されるビューがアクティブになり、 ContentControl

では、現在画面に表示されるビューになります。

ご注意

アクティブなビューを決定することは、ナビゲーションプロセスで特に重要です。多くの場合、アクティブビューがナビゲーションに参加する必要がある場合があります。たとえば、ユーザーがデータを離れる前にデータを保存したり、操作のキャンセルまたは確認を要求したりする場合です。

Prismの以前のバージョンでは、2つの異なる方法で地域の表現を表示できました。 ビューインジェクションと呼ばれる最初の方法は、領域内の表現をプログラムで表示することを可能にしました。このアプローチは、動的コンテンツを表示する場合、リージョンに表示する必要があるビューが頻繁に変更され、アプリケーションロジックを表示する場合に役立ちます。

ビューの埋め込みは、 Region

クラスでAdd

メソッドを提供することでサポートされていRegion

。次のコードは、 RegionManager

クラスを介してRegion

オブジェクトへの参照を取得し、プログラムでビューを追加する方法を示しています。この例では、DIコンテナを使用してビューが作成されます。

 IRegionManager regionManager = ...; IRegion mainRegion = regionManager.Regions["MainRegion"]; InboxView view = this.container.Resolve<InboxView>(); mainRegion.Add(view);

ビュー検出と呼ばれる次の方法では、モジュールがビュー名と領域名のマッピングを登録できます。指定された名前の領域が画面に表示されると、対応するビューのインスタンスが自動的に作成され、この領域に表示されます。このハイキングは、領域に表示されるビューが変わらないときに比較的静的なコンテンツを表示するのに役立ちます。

ビューの検出は、 RegionManager

クラスのRegisterViewWithRegion

メソッドを通じてサポートされます。このメソッドを使用すると、指定された名前の領域が表示されたときに呼び出されるコールバックメソッドを指定できます。次の例は、 「MainRegion」という名前の領域を表示するときに（依存性注入コンテナーを使用して）ビューを作成する方法を示しています。

 IRegionManager regionManager = ...; regionManager.RegisterViewWithRegion("MainRegion", () => container.Resolve<InboxView>());

Prismリージョンのより詳細な概要については、「ユーザーインターフェイスの作成」の章を参照してください。記事の残りの部分では、ナビゲーションをサポートするためにリージョンがどのように拡張されたか、および前述の問題を克服する方法について説明します。

地域の基本的なナビゲーション

リージョンにリプレゼンテーションを表示する上記の方法はいずれも、ナビゲーションのいくつかの制限された形式と見なすことができます。リプレゼンテーションの導入は明示的なプログラムナビゲーションの形式であり、リプレゼンテーションの検出は暗黙的または遅延ナビゲーションです。ただし、Prism 4.0では、URIと拡張可能なナビゲーションメカニズムに基づいたより一般的なナビゲーションの概念をサポートするために、リージョンが拡張されました。

領域内を移動するとは、その領域に新しいビューを表示することを意味します。表示されるビューはURIで識別されます。URIは、デフォルトでは、ナビゲーションが実行されるビューの名前を指します。 INavigateAsync

インターフェイスで定義されたRequestNavigate

メソッドを使用して、プログラムでナビゲーションを開始できます。

ご注意

その名前にもかかわらず、 INavigateAsync

インターフェイスINavigateAsync

、別のスレッドで実行される非同期ナビゲーションを意味INavigateAsync

ん。対照的に、 INavigateAsync

は擬似非同期ナビゲーションが含まれます。 RequestNavigate

メソッドは、ナビゲーションの終了後に同期的に終了することも、ユーザーがナビゲーションを確認する必要がある場合など、ナビゲーションの終了前に終了することもできます。ナビゲーション中にコールバックメソッドを指定できるようにすることで、Prismは、バックグラウンドスレッドの処理を複雑にすることなく、このようなシナリオをサポートできるようにします。

INavigateAsync

インターフェイスはRegion

クラスを実装し、この領域でナビゲーションを開始できるようにします。

 IRegion mainRegion = ...; mainRegion.RequestNavigate(new Uri("InboxView", UriKind.Relative));

また、 RegionManager

オブジェクトでRequestNavigate

メソッドを呼び出して、ナビゲーションが実行される領域の名前を指定することもできます。このメソッドは、対応する領域へのリンクを見つけ、その領域でRequestNavigate

メソッドを呼び出します。これを以下の例に示します。

 IRegionManager regionManager = ...; regionManager.RequestNavigate("MainRegion", new Uri("InboxView", UriKind.Relative));

デフォルトでは、ナビゲーションURIは、コンテナに登録されるビューの名前を設定します。以下のコードは、Unityコンテナのビュー登録名とナビゲーション中のこの名前の使用との関係を示しています。

 container.RegisterType<object, InboxView>("InboxView"); regionManager.Regions[Constants.MainRegion].RequestNavigate(new Uri("InboxView", UriKind.Relative));

ご注意

ナビゲーションサービスによってビューを作成するとき、ナビゲーションURIで指定された名前を使用して、コンテナからObject

型のObject

要求します。これをサポートするために、コンテナごとに異なる登録メカニズムが使用されます。たとえば、Unityでは、 Object

タイプをこのビューと一致させ、ナビゲーションURIの名前に対応する登録名を指定して、ビューを登録する必要があります。 MEFでは、 ExportAttribute

属性でコントラクトの名前を指定するだけです。

例。 Unityを使用してビューを登録する場合：

使用しないでください：

 container.RegisterType<InboxView>("InboxView");

代わりに使用します：

 container.RegisterType<object,InboxView>("InboxView");

ご注意

登録とナビゲーションに使用される名前は、ビュータイプの名前に関連付ける必要はありません。文字列は関連付けます。たとえば、文字列の代わりに、完全修飾型名を明示的に使用できます： typeof(InboxView).FullName

;

MEFでは、目的の名前でビューを単純にエクスポートできます。

 [Export("InboxView")] public partial class InboxView : UserControl { ... }

ナビゲーション中に、対応するビューモデルおよびその他の依存関係とともに、特定のビューがコンテナから要求されます。その後、指定された領域に追加されてアクティブ化されます（アクティブ化の詳細については、記事で詳しく説明します）。

ご注意

上記の説明は、URIがエクスポートまたはコンテナーに登録されたビューの名前を参照する場合のビュー優先ナビゲーションを示しています。 ビュー優先ナビゲーションでは、依存ビューモデルがビューの依存関係として作成されます。別のアプローチは、 ビューモデルを使用することです。最初のナビゲーションでは、ナビゲーションURIがコンテナに登録されたビューモデルの名前を参照します。このアプローチは、ビューがデータテンプレートとして定義されている場合、またはナビゲーションスキームをビューとは別に定義する場合に役立ちます。

RequestNavigate

メソッドを使用すると、ナビゲーションが完了したときに呼び出されるコールバックメソッドを設定することもできます。

 private void SelectedEmployeeChanged(object sender, EventArgs e) { ... regionManager.RequestNavigate(RegionNames.TabRegion, "EmployeeDetails", NavigationCompleted); } private void NavigationCompleted(NavigationResult result) { ... }

NavigationResult

クラスには、ナビゲーション操作に関する情報を取得できるプロパティがあります。 Result

プロパティは、ナビゲーションが完了したかどうかを示します。ナビゲーションが失敗した場合、 Error

プロパティには、ナビゲーション中にスローされた例外へのリンクが含まれます。 Context

プロパティを使用して、ナビゲーションURIとそれに含まれるパラメーター、およびナビゲーション操作を調整するサービスへのリンクにアクセスできます。

ナビゲーションへのビューおよびプレゼンテーションモデルの関与

多くの場合、アプリケーションのビューとビューモデルの両方がナビゲーションに参加することを望みます。これはINavigationAware

インターフェイスINavigationAware

できます。このインターフェイスは、ビュー、または（より頻繁に）ビューモデルに実装できます。実装することにより、プレゼンテーションまたはプレゼンテーションモデルをナビゲーションプロセスに直接関与させることができます。

ご注意

以下の説明では、ビュー間でナビゲーションが発生することを前提としています。ただし、ビューまたはビューのモデルに実装されているかどうかに関係なく、ナビゲーション中にINavigationAware

インターフェイスがINavigationAware

れることに注意してINavigationAware

。ナビゲーション中に、PrismはINavigationAware

実装しているかどうかを確認します。実装されている場合、必要なメソッドが呼び出されます。また、Prismは、ビューのDataContext

プロパティが設定されているオブジェクトでこのインターフェイスの実装のチェックを行い、成功した場合、必要なメソッドを呼び出します。

このインターフェイスを使用すると、ビューまたはビューモデルをナビゲーション操作に参加させることができます。 INavigationAware

インターフェイスは、3つのメソッドを定義します。

 public interface INavigationAware { bool IsNavigationTarget(NavigationContext navigationContext); void OnNavigatedTo(NavigationContext navigationContext); void OnNavigatedFrom(NavigationContext navigationContext); }

IsNavigationTarget

メソッドを使用すると、リージョン内の既存のビュー、またはビューモデルで、ナビゲーション要求を処理できるかどうかを表示できます。これは、既存のビューを再利用してナビゲーションを処理する場合、または既存のビューに移動する場合に役立ちます。たとえば、さまざまな顧客が選択されると、顧客情報を表示するビューが更新されます。詳細については、後の「既存のビューへの移動」セクションを参照してください。

OnNavigatedFrom

およびOnNavigatedTo

は、ナビゲーション操作中に呼び出されます。領域内の現在のアクティブビュー（またはそのビューモデル）がこのインターフェイスを実装している場合、ナビゲーションが開始される前にOnNavigatedFrom

メソッドOnNavigatedFrom

呼び出されます。 OnNavigatedFrom

メソッドを使用すると、前のビューで状態を保存したり、非アクティブ化またはユーザーインターフェイスからの削除を準備したりできます。たとえば、ビューは、ユーザーが行った変更をデータベースに保存したり、Webサービスに送信したりできます。

新しく作成されたビュー（またはビューモデル）がこのインターフェイスを実装している場合、ナビゲーション後にOnNavigatedTo

メソッドOnNavigatedTo

呼び出されます。 OnNavigatedTo

メソッドを使用すると、ナビゲーションURIとともに渡されるパラメーターを使用して、表示されたばかりのビューを初期化できます。詳細については、次のセクション「ナビゲーション中のパラメーターの受け渡し」を参照してください。

ターゲット領域に新しいビューを作成、初期化、追加すると、アクティブになり、前のビューが非アクティブになります。場合によっては、非アクティブ化されたビューを領域から削除する必要があります。 PrismにはIRegionMemberLifetime

インターフェイスがあり、非アクティブ化されたビューをリージョンからすぐに削除するか、単に非アクティブとしてマークするかを設定することで、リージョン内のビューの存続期間を制御できます。

 public class EmployeeDetailsViewModel : IRegionMemberLifetime { public bool KeepAlive { get { return true; } } }

IRegionMemberLifetime

インターフェイスは、単一の読み取り専用のKeepAlive

プロパティを定義します。 false

に設定されてfalse

場合、ビューは非アクティブ化されたときにリージョンから削除されます。その後、領域はビューへのリンクの保存を停止するため、ガベージコレクターから到達できます（もちろん、アプリケーションの他の部分が参照している場合を除きます）。このインターフェイスは、ビューとビューモデルの両方に実装できます。 IRegionMemberLifetime

インターフェイスIRegionMemberLifetime

、ほとんどの場合、アクティブ化および非アクティブ化中に領域のビューの有効期間を制御することを目的としていますが、ターゲット領域でビューを作成およびアクティブ化した後のナビゲーション中にKeepAlive

プロパティも使用されます。

ご注意

, , ItemsControl

, TabControl

, , . , , .

必要なナビゲーション動作を実装するには、多くの場合、ターゲットビューの名前に加えて、ナビゲーションリクエスト中に送信される追加データを指定する必要があります。このオブジェクトNavigationContext

は、ナビゲーションURIと、それに渡されたすべてのパラメーターへのアクセスを提供します。あなたはへのアクセスを得ることができるNavigationContext

ようにIsNavigationTarget

、OnNavigatedFrom

とOnNavigatedTo

。

ナビゲーションパラメータの設定と取得を支援するために、Prismにクラスが存在しUriQuery

ます。必要に応じて、ナビゲーションを開始する前にナビゲーションパラメータをURIに追加し、ナビゲーション中にこれらのパラメータにアクセスするために使用できます。UriQuery

各パラメーターの名前と値のペアを含むリストを作成します。

次のコード例は、パラメーターを追加する方法を示していますUriQuery

それらをナビゲーションURIに添付します。

 Employee employee = Employees.CurrentItem as Employee; if (employee != null) { UriQuery query = new UriQuery(); query.Add("ID", employee.Id); _regionManager.RequestNavigate(RegionNames.TabRegion, new Uri("EmployeeDetailsView" + query.ToString(), UriKind.Relative)); }

Parameters

オブジェクトのプロパティを使用してナビゲーションパラメータを取得できますNavigationContext

。このプロパティは、UriQuery

個々のパラメーターへのアクセスを簡素化するインデクサープロパティを持つクラスのインスタンスを返します。

 public void OnNavigatedTo(NavigationContext navigationContext) { string id = navigationContext.Parameters["ID"]; }

既存のビューに移動する

多くの場合、ナビゲーション中にビューを再利用、更新、またはアクティブ化する方が、新しいビューに置き換えるよりも望ましい方法です。これは、同じタイプのビューにナビゲートしているが、他のデータを表示したい場合、または目的のビューが既に使用可能であるが、アクティブ化が必要な場合（強調表示または上に移動する場合）の典型的なケースです。

最初のシナリオの例は、アプリケーションがビューを使用してクライアントに関する情報を変更することをユーザーに許可する状況でEditCustomer

あり、ユーザーはすでにこのビューを使用してID 123のクライアントを編集します。ユーザーがID 456のクライアントレコード提出EditCustomer

新しいIDを入力します。その後、ビューEditCustomer

は新しいクライアントに関するデータを要求し、それに応じてUIを更新します。

2番目のシナリオの使用例として、アプリケーションで複数のクライアントに関する情報を一度に編集できると仮定します。この場合、アプリケーションは、ID 123およびID 456のクライアントなど、いくつかのビューEditCustomer

を表示しますTabControl

。ID456に移動しEditCustomer

て入力すると、対応するビューがアクティブになります（つまり、対応するタブが強調表示されます）。ユーザーがビューに移動してEditCustomer

ID 789を入力すると、新しいインスタンスが作成され、UIに表示されます。

既存のビューにナビゲートする機能は、さまざまな理由で役立ちます。多くの場合、既存のビューを同じタイプの新しいビューで置き換えるよりも、既存のビューを更新する方がはるかに効率的です。同様に、新しいビューを作成する代わりに既存のビューをアクティブにすると、インターフェイスの一貫性が高まります。さらに、追加のコード記述を必要とせずにこのようなシナリオを処理できるため、アプリケーションの開発とサポートが簡素化されます。

Prismは、メソッドを通じて上記の両方のシナリオをサポートしますINavigationAware.IsNavigationTarget

。このメソッドは、ターゲットビューと同じタイプの領域内のビューのナビゲーション中に呼び出されます。前の例では、ターゲットビューはtype EditCustomer

であったため、メソッドIsNavigationTarget

はtypeの既存のすべてのビューで呼び出されますEditCustomer

地域に位置しています。Prismは、ナビゲーションURIを使用してターゲットビュータイプを定義します（ターゲットビュータイプの短縮名であると想定）。

ご注意

Prismがターゲットビューのタイプを決定するには、ナビゲーションURIのビューの名前がそのタイプの短縮名と一致する必要があります。たとえば、ビューにclassがある場合MyApp.Views.EmployeeDetailsView

、ナビゲーションURIで指定されたビューの名前はEmployeeDetailsViewである必要があります。これは標準のPrismの動作です。独自のコンテンツローダークラスを作成することで変更できます。これを行うには、インターフェイスを実装するIRegionNavigationContentLoader

か、からクラスを継承しますRegionNavigationContentLoader

。

このメソッドの実装ではIsNavigationTarget

、パラメーターNavigationContext

を使用して、ビューがナビゲーション要求を処理できるかどうかを判断できます。NavigationContext

ナビゲーションURIおよびナビゲーションパラメータへのアクセスを提供します。前の例では、プレゼンテーションモデルでのこのメソッドの実装によりEditCustomer

、現在のクライアントIDとナビゲーション要求で指定されたIDが比較され、true

一致する場合に返されます。

 public bool IsNavigationTarget(NavigationContext navigationContext) { string id = navigationContext.Parameters["ID"]; return _currentCustomer.Id.Equals(id); }

メソッドIsNavigationTarget

がtrue

ナビゲーションパラメータに関係なく常にを返す場合、このビューは常に再利用されます。このようなアプローチにより、特定の地域では特定のタイプの表現が1つだけになることが保証されます。

ナビゲーションを確認またはキャンセルする

多くの場合、ナビゲーション中にユーザーと対話し、ユーザーが確認またはキャンセルできるようにする必要があります。多くのアプリケーションでは、たとえば、ユーザーはデータを入力または編集しながらナビゲーションを開始できます。そのような状況では、保存するか、ページを離れる前に行った変更を破棄するか、またはナビゲーションを完全にキャンセルするかをユーザーに尋ねる必要があります。 Prismはインターフェイスを介してこのようなシナリオをサポートしますIConfirmNavigationRequest

。

インターフェイスはインターフェイスIConfirmNavigationRequest

から継承され、メソッドINavigationAware

を追加しますConfirmNavigationRequest

。ビューまたはビューモデルにこのインターフェイスを実装すると、ユーザーがナビゲーションプロセスに参加できるようになり、ユーザーと対話して、ユーザーがナビゲーションをキャンセルまたは確認できるようになります。確認ポップアップを表示するには、第6部、高度なMVVMスクリプトで説明されているInteraction Requestオブジェクトを使用する必要がある場合もあります。

ご注意

このメソッドConfirmNavigationRequest

は、OnNavigatedFrom

前述のメソッドと同様に、アクティブビュー（またはビューモデル）で呼び出されます。

このメソッドConfirmNavigationRequest

は、2つのパラメーター、上記の現在のナビゲーションコンテキストへのリンク、およびナビゲーションを続行するために呼び出す必要があるデリゲートを受け入れます。このため、このデリゲートはしばしば継続コールバックデリゲートと呼ばれます。ユーザー操作の終了後に呼び出すために、デリゲート継続へのリンクを保存できます。アプリケーションがInteraction Requestオブジェクトを介してユーザーと対話する場合、このデリゲートを対話要求コールバックのメソッドとして使用できます。次の図は、完全なプロセスを示しています。

インタラクションリクエストオブジェクトを使用してナビゲーションを確認する

次の手順では、オブジェクトを使用するときのナビゲーション確認プロセスについて説明しますInteractionRequest

。

ナビゲーションは、メソッド呼び出しを通じて開始されますRequestNavigate

。
, IConfirmNavigation

, ConfirmNavigationRequest

.
( interaction request event ).
.
, .
- , .
, .

この図を表示するには、「ビュー切り替えナビゲーションクイックスタート」を参照してください。このアプリケーションは、クラスを使用して、ユーザーが電子メールメッセージを作成することができますComposeEmailView

、とComposeEmailViewModel

。ビューモデルクラスはインターフェースを実装しますIConfirmNavigation

。たとえば、メッセージの作成中にカレンダーボタンを押すなどしてユーザーがナビゲートConfirmNavigationRequest

すると、ビューモデルがユーザーに確認を要求できるようにメソッドが呼び出されます。これをサポートするために、次の例に示すように、ビューモデルは対話要求オブジェクトを定義します。

 public class ComposeEmailViewModel : NotificationObject, IConfirmNavigationRequest { private readonly InteractionRequest<Confirmation> confirmExitInteractionRequest; public ComposeEmailViewModel(IEmailService emailService) { this.confirmExitInteractionRequest = new InteractionRequest<Confirmation>(); } public IInteractionRequest ConfirmExitInteractionRequest { get { return this.confirmExitInteractionRequest; } } }

ビューモデルのプロパティにバインドComposeEmailVew

されているクラスにトリガーが割り当てられます。インタラクションをリクエストすると、シンプルなポップアップウィンドウがユーザーに表示されます。InteractionRequestTrigger

ConfirmExitInteractionRequest

 <UserControl.Resources> <DataTemplate x:Name="ConfirmExitDialogTemplate"> <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Text="{Binding}"/> </DataTemplate> </UserControl.Resources> <Grid x:Name="LayoutRoot" Background="White"> <ei:Interaction.Triggers> <prism:InteractionRequestTrigger SourceObject="{Binding ConfirmExitInteractionRequest}"> <prism:PopupChildWindowAction ContentTemplate="{StaticResource ConfirmExitDialogTemplate}"/> </prism:InteractionRequestTrigger> </ei:Interaction.Triggers> ...

ユーザーがメッセージの作成中にナビゲートしようとすると、ConfirmNavigationRequest

クラスメソッドComposeEmailVewMode

が呼び出されます。このメソッドの実装は、ユーザーがナビゲーション操作を確認または変更できるように、以前に定義された対話要求を発生させます。

 void IConfirmNavigationRequest.ConfirmNavigationRequest( NavigationContext navigationContext, Action<bool> continuationCallback) { this.confirmExitInteractionRequest.Raise( new Confirmation {Content = "...", Title = "..."}, c => {continuationCallback(c.Confirmed);}); }

ユーザーが確認ポップアップウィンドウのボタンをクリックすると、インタラクションをリクエストするためのコールバックメソッドが呼び出されます。それは単に継続デリゲートを呼び出し、それにフラグ値を渡してConfirmed

、ナビゲーションを確認またはキャンセルすることを強制します。

ご注意

, Rise

, ConfirmNavigationRequest

, UI . OK , Cancel , , , , - . UI. .

このメカニズムを使用すると、ナビゲーション要求をすぐに実行するか、ユーザーの応答またはWebサーバーへの要求などの他の非同期操作を待って遅延して実行するかを制御できます。ナビゲーションを続行して確認するには、デリゲート継続を呼び出して渡すだけでtrue

、ナビゲーションをキャンセルし、転送する必要がありますfalse

。

 void IConfirmNavigationRequest.ConfirmNavigationRequest( NavigationContext navigationContext, Action<bool> continuationCallback) { continuationCallback(true); }

ナビゲーションを延期する場合は、リンクをデリゲート継続に保存できます。このリンクは、ユーザーインタラクションの終了後、または非同期リクエスト（Webサーバーなど）の後に呼び出すことができます。ナビゲーション操作は、継続デリゲートが呼び出されるまで保留されます。

この時点でユーザーが別のナビゲーションを開始すると、ナビゲーションリクエストはキャンセルされます。この場合、継続デリゲートを呼び出しても効果はありません。同様に、継続デリゲートを呼び出さないことにした場合、ナビゲーション操作は新しいナビゲーション操作に置き換えられるまで保留されます。

ナビゲーション履歴を使用する（ナビゲーション・ジャーナル）

このクラスNavigationContext

は、地域のナビゲーションサービスへのアクセスを提供します。このサービスは、地域内のナビゲーション中の操作のシーケンスを調整する役割を果たします。ナビゲーションが実行される地域、およびこの地域に関連付けられたナビゲーションログへのアクセスを提供します。ナビゲーションサービスは、IRegionNavigationService

以下に示すインターフェイスを実装します。

 public interface IRegionNavigationService : INavigateAsync { IRegion Region { get; set; } IRegionNavigationJournal Journal { get; } event EventHandler<RegionNavigationEventArgs> Navigating; event EventHandler<RegionNavigationEventArgs> Navigated; event EventHandler<RegionNavigationFailedEventArgs> NavigationFailed; }

このインターフェイスはインターフェイスから継承されるためINavigateAsync

、メソッドを呼び出して親領域でナビゲーションを開始できますRequestNavigate

。Navigating

ナビゲーション操作が開始されると、イベントが発生します。このイベントNavigated

は、リージョン内のナビゲーションが完了すると発生します。NavigationFailed

ナビゲーション中にエラーが発生したときに呼び出されます。

このプロパティJournal

は、地域に関連付けられたナビゲーションログへのアクセスを提供します。ナビゲーションログは、IRegionNavigationJournal

以下に示すインターフェイスを実装します。

 public interface IRegionNavigationJournal { bool CanGoBack { get; } bool CanGoForward { get; } IRegionNavigationJournalEntry CurrentEntry { get; } INavigateAsync NavigationTarget { get; set; } void Clear(); void GoBack(); void GoForward(); void RecordNavigation(IRegionNavigationJournalEntry entry); }

メソッド呼び出しを介したナビゲーション中に、ビュー内の地域のナビゲーションサービスへのリンクを取得および保存できますOnNavigatedTo

。デフォルトでは、Prismは、リージョン内を前後に移動できるシンプルなスタックログを提供します。

ナビゲーションログを使用して、ユーザーがビュー自体をナビゲートできるようにします。次の例では、ビューモデルGoBack

は、親領域のナビゲーションログを使用するコマンドを実装します。そのため、ビューには[ 戻る ]ボタンが表示され、ユーザーは領域内の前のビューに移動できます。同様に、GoForward

ウィザード形式のワークフローを作成するコマンドを実装できます（ウィザードスタイルのワークフロー）。

 public class EmployeeDetailsViewModel : INavigationAware { ... private IRegionNavigationService navigationService; public void OnNavigatedTo(NavigationContext navigationContext) { navigationService = navigationContext.NavigationService; } public DelegateCommand<object> GoBackCommand { get; private set; } private void GoBack(object commandArg) { if (navigationService.Journal.CanGoBack) { navigationService.Journal.GoBack(); } } private bool CanGoBack(object commandArg) { return navigationService.Journal.CanGoBack; } }

リージョンに独自のジャーナルを作成して、そのリージョンに特定のワークフローを実装できます。

ご注意

ナビゲーションログは、地域のナビゲーションサービスによって調整された地域のナビゲーション操作でのみ使用できます。ビューを検出または導入する手法を使用してリージョン内のナビゲーションを実装する場合、ナビゲーションログはナビゲーション中に更新されず、リージョン内で前後にナビゲートするために使用することはできません。

使用してWPFとSilverlightのナビゲーションフレームワーク

Prismの地域ナビゲーションは、MVVMパターンとUnityやMEFなどの依存性注入コンテナーを使用して疎結合モジュラーアプリケーションでナビゲーションを実装するときに発生する可能性のあるさまざまなシナリオと問題をサポートするように設計されました。また、ナビゲーションの確認とキャンセル、既存のビューへのナビゲーション、ナビゲーション中のパラメーターの受け渡し、およびナビゲーションログの維持をサポートするように設計されました。

リージョンのナビゲーションをサポートするPrismは、多くのコントロール要素内をナビゲートする機能を提供し、ナビゲーション構造に違反することなくアプリケーションのユーザーインターフェイスのレイアウトを変更できるようにします。擬似同期ナビゲーションもサポートされており、ナビゲーション中のユーザーインタラクションを強化できます。

ただし、Prismナビゲーションは、Silverlightナビゲーションフレームワーク（Silverlight 3.0で導入）またはWPFのナビゲーションフレームワークを置き換えるようには設計されていません。代わりに、Prismリージョンのナビゲーションは、SilverlightおよびWPFナビゲーションフレームワークで動作するように設計されています。

Silverlightナビゲーションフレームワークディープリンクサポート、ブラウザ統合、およびナビゲーションURIの投影を提供します。コントロール内でナビゲーションが可能Frame

です。Frame

必要に応じて、アドレスバーを表示して、ユーザーがに表示されているビュー間を前後に移動できるようにすることができますFrame

。通常のアプローチは、Silverlightナビゲーションフレームワークを使用して、アプリケーションシェルで高レベルナビゲーションを実装し、アプリケーションの他のすべての部分にPrismナビゲーションを使用することです。この場合、アプリケーションはディープリンクをサポートし、ブラウザーログとそのアドレスバーに統合されます。また、Prismリージョンでのナビゲーションのすべての利点を享受できます。

WPFナビゲーションフレームワークSilverlightほど拡張性がありません。したがって、依存性注入とMVVMパターンのサポートは非常に困難です。またFrame

、ロギングとナビゲーションUIの点で同様の機能を持つコントロールに基づいています。Prismナビゲーションと共にWPFナビゲーションフレームワークを使用できますが、Prism領域のみを使用してナビゲーションを実装すると、よりシンプルで柔軟なソリューションになる場合があります。

地域ナビゲーションシーケンス

次の図は、ナビゲーション中の操作の流れの概要を示しています。ナビゲーションリクエスト中にさまざまなPrismナビゲーション要素がどのように相互作用するかを確認できるように、参照として提供されます。

地域ナビゲーションシーケンス

追加情報

Visual State Managerの詳細については、MSDNの「VisualStateManagerクラス」http://msdn.microsoft.com/en-us/library/cc626338(v=VS.95).aspxを参照してください。

：マイクロソフトのExpression Blendのの行動を使用しての詳細については、MSDNの«内蔵の行動で作業を»参照http://msdn.microsoft.com/en-us/library/ff724013(v=Expression.40).aspx。

：MSDNに«カスタムビヘイビアを作成する»を参照、マイクロソフトのExpression Blendのの行動を作成する方法の詳細についてはhttp://msdn.microsoft.com/en-us/library/ff724708(v=Expression.40).aspx。

Silverlight ナビゲーションフレームワークの詳細についてはMSDNで見る«ナビゲーションの概要»：http://msdn.microsoft.com/en-us/library/cc838245(VS.95).aspx。

SilverlightのナビゲーションフレームワークとPrismの統合の詳細については、Karl Schifflettのブログ（http://blogs.msdn.com/b/kashiffl/archive/2010/10/05）の「Prism v4リージョンナビゲーションとSilverlightフレームナビゲーションの統合」を参照してください。/integrating-prism-v4-region-navigation-with-silverlight-frame-navigation.aspx。

Prism開発者ガイド-パート8.1、ビューベースのナビゲーション