15: Prism Library 5.0 for WPFを拡張する

Container and Bootstrapper

Prism Libraryは、直接、依存関係注入コンテナとして、Unityアプリケーション・ブロック（Unity）と拡張管理フレームワーク(MEF)をサポートしています。; しかしながら、コンテナが、IServiceLocatorインターフェイスによって呼び出されるため、コンテナは、置き換えることができます。

各々のPrismアプリケーションは、ブートストラッパー・クラスによってPrism Libraryを設定します。ブートストラップ工程の各段階は、工程そのものと同様に、交換可能です。 ブートストラッパーは、デフォルトの実装をカスタム実装で、あるいは、追加のデータ型とサービスを登録する、交換をするために、重要な拡張ポイントを提供します。

Logging

いくつかのPrism Libraryコンポーネントは、情報、警告メッセージやエラーメッセージを記録します。 個々のログの記録アプローチの依存関係を回避するために、それは、ILoggerFacadeインターフェイスに、これらのメッセージを記録します。 一般的な拡張は、特定のアプリケーションのためのカスタム・ロガーを提供します。

Modules

Prism Libraryは、モジュール・カタログを埋め込むさまざまな方法とロードモジュールを提供します。; しかしながら、あなたのシナリオは、ライブラリを与えない必要があるかもしれません。

モジュールの読み込みは、次の3つの段階が含まれています。それは、カスタマイズすることができます。：

• モジュール発見。これは、モジュール・カタログを埋め込む工程です。 頻繁に、これは、直接、あるいは、ディレクトリを掃引することにより行われます。 しかし、あなたのアプリケーションは、データベースからのような、いくつかのその他の方法で行う必要があるかもしれません。 これらの場合では、あなたは、適切なソースからそれ自体を埋め込む、カスタム・カタログを作成することができます。
• モジュールの検索と読み込み。これは、ローカルに、モジュール・バイナリを取得する工程です。 そして、現在のアプリケーション・ドメインに、モジュールを読み込みます。 ライブラリは、FileModuleTypeLoaderを提供しますが、あなた独自の探索戦略を実装することもできます。
• モジュールの初期化。これは、モジュールを初期化する工程です。 ライブラリでは、これは、ModuleInitializerによって行われます。 しかし、それは、IModuleInitialzerを実装する、新しいオブジェクトを提供することで、置き換えることができます。

Prismライブラリは、領域として、コントロールを可能にするために、既定のコントロール・アダプタを提供します。 領域の周りの拡張は、カスタム領域アダプタ、カスタム領域を与える、あるいは、領域マネージャーを置き換えることを必要とするかもしれません。 あなたが、それは、与えられた領域アダプタでは、動作しない、カスタムWPFコントロールやサードパーティ製のコントロールを持っている場合、 あなたは、カスタム領域アダプタを作成するといいかもしれません。 また、それは、コンテナに、新しいIRegionManagerを提供することによって、既定のRegionManagerを置き換えることができます。

Region Navigation

また、Prism Libraryの領域機能は、ナビゲーションをサポートしています。戻る/進むの更新履歴サポートが含まれています。 領域の中のViewは、INavigationAwareインターフェイスを通して、ナビゲーション内で、拡張、そして、関与することができます。 Silverlightナビゲーション機能に精通している開発者は、Frameクラスに類似した領域を見つけるでしょう。 領域ナビゲーションは、いくつかの拡張ポイントをサポートしています。 それは、ナビゲーション・サービスの置き換えに加えて、アプリケーションの論理的なナビゲーション構造を変更するために、それを可能にします。

RegionNavigationContentLoaderクラスは、NavigationContextに基づいた領域に、内容を読み込む能力を提供します。 移動される内容が、すでに領域内にある場合、RegionNavigationContentLoaderは、その内容を配置します。 そして、領域を追加するための新しい内容を作成する代わりに、それをアクティブとして作成します。 RegionNavigationContentLoader.GetCandidatesFromRegionメソッドは、 型で、それらと一致している領域Viewを検索します。 しかしながら、それは、Viewが、解決するために使用される型と一致しない型を持つことは、可能です。 例えば、あなたは、「親しみやすい」名前を使用して、依存関係注入コンテナで、Viewを登録することができました。 それは、あなたのView型の名前と一致しません。

C#

[Export("FriendlyName")]
public class MyViewType

Prismライブラリは、UnityRegionNavigationContentLoaderとMefRegionNavigationContentLoaderを発送します。 それは、可能な親しみやすい名前の登録をView型に基づいて見つけるのに、必要な特別な処理を提供する、 GetCandidatesFromRegion基底メソッドを上書きします。 あなたが、UnityRegionNavigationContentLoaderかMefRegionNavigationContentLoaderを使用していない場合、 続いて、依存関係注入コンテナに、あなたが使用する、RegionNavigationContentLoaderの部分クラスに操作が追加されていることを確認します。

Container and Bootstrapper

Prism Libraryには、Bootstrapper基底クラスが含まれています。UnityとMEFコンポーネントは、 それぞれ、UnityBootstrapperとMefBootstrapperとして、このクラスから派生します。 Bootstrapper基底クラスは、工程の正確な順序付けを、派生クラスに残す、抽象的なRunメソッドを定義します。 ほとんどすべてのメソッドは、カスタマイズ、そして、ブートストラップ工程を拡張するために、それぞれのメソッドを上書できる、仮想であるように、マークされます。

ほとんどの型のインスタンス化のために、ブートストラッパーは、依存関係注入コンテナを使用するでしょうしかしながら、 コンテナを使用することができない、ブートストラップ工程のいくつかの部分があります。：

• ロガーを作成する

  通常、ロガーは、まず、（コンテナの前に）作成されます。 ブートストラッパーは、コンテナを作成することに関する情報を記録する必要があるため、 ログの記録の実装を変更することの詳細については、「ログの記録」の項目を参照してください。

• カタログを作成して、設定する

  カタログ（たとえば、ModuleCatalogとAggregateCatalog）は、 コンテナ構築の間、使用されるため、コンテナの前に、作成されます。

• シェルを作成する

  ブートストラップ・シーケンスを実行する前に、シェルがすでに存在するかもしれないため、 CreateShellメソッドは、実装するアプリケーション開発者のため、抽象として、残っています。 アプリケーション開発者は、コンテナが作成され、そして、初期化されたため、シェルをインスタンス化、 あるいは、配置するために、コンテナを使用することができます。

Replacing Default Prism Library Types

あなたが、アプリケーションのために、Prism Library型の基盤となる実装を変更、 あるいは、拡張する必要があるとき、時間があるかもしれません。 Prism Libraryが、依存関係注入に依存するため、あなたは、ブートストラップ・シーケンスの間、型を置き換えることができます。 そして、あなたのアプリケーションとPrism Libraryは、新しい型を使用するでしょう。

Replacing Default Types Using Unity

UnityBootstrapper.ConfigureContainerメソッドが、呼び出される前に、 どんな置換型でも、コンテナに登録しまし、型を置き換えるでしょう。その関連付けられたインターフェイスが、すでに登録されていない場合、 ConfigureContainerデフォルトの実装は、Prism Library型を追加するためだけに、RegisterTypeIfMissingメソッドを使用します。

Prism Library型をUnityに置き換えるために、 まず、あなたが、置き換えたい、インターフェイスやクラスから、あなたの新しい型を派生します。 次のコード例は、IEventAggregatorインターフェイスの置き換えを示します。

C#

// when using Unity
public class ReplacementEventAggregator : IEventAggregator 
{
    // ...
}

今、あなたは、ブートストラッパーで、ConfigureContainerメソッドを上書きする、インターフェイスと型を登録する、 基底クラスを呼び出す前に、置き換えた型を持っています。 次のコード例は、どのように、IEventAggregatorの置き換えを登録するかを示します。

C#

// when using Unity
protected override void ConfigureContainer()
{
    this.RegisterTypeIfMissing(typeof(IEventAggregator), typeof(ReplacementEventAggregator), true);
 
    base.ConfigureContainer();
}

Replacing Default Types Using MEF

MefBootstrapper.ConfigureContainerメソッドが、呼び出される前に、どんな置換型でも、コンテナに登録し、型を置き換えるでしょう。 その関連付けられたインターフェイスが、すでに登録されていない場合、ConfigureContainerの既定の実装は、Prism Library型を一つだけ追加します。

Prism Library型をMEFに置き換えるために、まず、あなたが望むインターフェイスから、適切なMEFエクスポート属性を、それに置き換えて、 適用するために、あなたの新しい型を派生します。次のコード例は、IEventAggregatorインターフェイスの置き換えを示します。

C#

// when using MEF
[Export(typeof(IEventAggregator))]
[PartCreationPolicy(CreationPolicy.Shared)]
public class ReplacementEventAggregator : IEventAggregator
{
    // ...
}

今、あなたは、ブートストラッパーで、ConfigureAggregateCatalogメソッドを上書きし、 そして、AggregateCatalog型に含まれるカタログを追加する、置き換えた型を持っています。 次のコード例は、置換型を追加するために、TypeCatalogを、どのように、使用するかを示しています。 また、AssemblyCatalogは、使用することができます。

C#

// when using MEF
protected override void ConfigureAggregateCatalog()
{
    this.AggregateCatalog.Catalogs.Add(new TypeCatalog(typeof(ReplacementEventAggregator)));

    base.ConfigureAggregateCatalog();
}

Registering Non-MEF Attributed Types with the MEF Container

あなたが、コードを所有し、そして、MEF上で、直接、依存関係を取得する場合、 あなたは、Export属性を型に追加するだけなので、MEFで型を登録することは、簡単です。 しかしながら、いくつかの状況では、あなたが、MEFアセンブリの上で、直接、依存関係を取得できないとき、 あなたは、MEFで、型を登録することを必要とするかもしれません。 この問題は、MEFサポートをPrismに追加している間に、設計目標の1つを確実とするため、 コアPrismライブラリが、コンテナ固有でなかったために、開発者が、直面しました。 これは、Microsoft.Practices.Prismアセンブリが、System.ComponentModel.Compositionを参照することができない、 そして、Export属性を使用することを示しています。 その代わりに、チームは、Microsoft.Practices.Prism.MefExtensionsアセンブリに、派生クラスを作成しました。 それは、チームが、公開することを望んだ型から派生し、そして、適切な型をエクスポートします。 MefRegionManagerクラスから、次のコード例は、RegionManagerから派生し、 そして、IRegionManagerとして、新しい型をエクスポートすることで、このアプローチの例を示しています。

C#

[Export(typeof(IRegionManager))]
public class MefRegionManager : RegionManager
{
}

Creating a Minimal Bootstrapper

一部のアプリケーションでは、Prism Libraryの機能の多くを使用していません。 場合によっては、アプリケーション開発者は、絶対最小のサービス水準を望むかもしれません。 －依存関係の注入とサービスの位置だけ、これを実行するには、 次に示すブートストラッパーと実装で、ConfigureContainerメソッドを上書きします。

C#

// when using UnityBootstrapper
// UnityBootstrapperを使用するとき、
protected override void ConfigureContainer()
{
    // Base class implementation deliberately not called
    // base.ConfigureContainer();
    // 基底クラスの実装は、故意に、base.ConfigureContainer()を呼び出しません。;
 
    this.Container.AddNewExtension<UnityBootstrapperExtension>();
    Container.RegisterInstance<ILoggerFacade>(Logger);
    this.Container.RegisterInstance(this.ModuleCatalog);            
    RegisterTypeIfMissing(typeof(IServiceLocator), typeof(UnityServiceLocatorAdapter), true);
}
 
protected override RegionAdapterMappings ConfigureRegionAdapterMappings()
{
    return null;
}
 
protected override IRegionBehaviorFactory ConfigureDefaultRegionBehaviors()
{
    return null;
}

備考

領域アダプタとマッピングのオーバーライドは、必要とされます。 Unityが、返すために、適切で、具体的な型を決定できないため、インターフェイスの実装が、要求されるとき、 これらは、それぞれのインターフェイスを返すために、具体的な型の関連付けを呼び出します。 必要とされる具体的な型が、要求されるとき、Unityは、型をインスタンス化することによって、直接、それらを解決することができます。

C#

// when using MEFBootstrapper
// MEFBootstrapperを使用するとき、
protected override void ConfigureContainer()
{
    // Base class implementation deliberately not called
    // base.ConfigureContainer();
    //基底クラスの実装は、故意に、base.ConfigureContainer()を呼び出しません。;
    
    this.Container.ComposeExportedValue<ILoggerFacade>(this.Logger);
    this.Container.ComposeExportedValue<IServiceLocator>(new MefServiceLocatorAdapter(this.Container));
    this.Container.ComposeExportedValue<AggregateCatalog>(this.AggregateCatalog);
}

Changing Dependency Injection Containers

あなたが、あなたのアプリケーションで、UnityやMEF以外のコンテナ付きのPrismを使用する場合、あなたが、行う必要がある、いくつかのことがあります。 まず、あなたは、あなたのコンテナのためのサービス・ロケーター・アダプタを記述することを必要とします。 あなたは、どのように、行うことができるかの例として、MefServiceLocatorAdapterとUnityServiceLocatorAdapterを使用することができます。 また、あなたは、コンテナ固有のブートストラッパー・クラスを記述する必要があります。 次に、あなたは、新しいコンテナ固有のブートストラッパーを作成する必要があります。 例として、MefBootstrapperとUnityBootstrapperの利用して、Bootstrapperクラスから派生し、そして、必要なメソッドを実装します。

Adding Features to the Module Catalog

Prismライブラリは、両方のクラスとして、ModuleCatalogを提供します。 あなたは、AddModuleメソッドを通して、直接、埋め込むことができます。 あるいは、あなたは、Itemsプロパティを埋め込むために、addメソッドから、派生することができます。

Prism LibraryのModuleCatalogクラスは、IModuleインターフェイスを越えた追加機能の多くを提供します。 AddModuleメソッド、モジュール・グループの依存関係の検証と並べ替えの多くの異なるオーバーロードがあリます。 ModuleCatalogの機能を拡張する、いくつかの方法があります。：

ModuleCatalogから派生します。 あなたが、ModuleCatalogの挙動を変更する必要がある場合、新しいクラスを派生し、そして、仮想メソッドを上書きします。

IModuleCatalog上で、拡張メソッドを記述します。 あなたが、IModuleCatalogを使用するアプリケーションにおいて、 追加の機能を必要とする場合、インターフェイス上で、拡張メソッドを記述します。

ModuleCatalog上で、拡張メソッドを記述します。 あなたが、追加の機能を必要とする場合、 しかし、あなたが、ModuleCatalogを使用する場所だけで、具体的な型の上で、拡張メソッドを記述します。

Discovering Modules from a Custom Source

Prism Libraryは、アプリケーション設定から、 そして、XAMLファイルから、モジュール・カタログを埋め込むことをサポートしています。 あなたは、Webサービス、データベース、他の外部ファイルのような、 他のデータ・ソースからの読み込みをサポートするために、あなたのアプリケーション内で、Prismを拡張できます。

以下は、カタログを埋め込むための、いくつかの方法を説明します。

• 静的CreateFromXamlメソッドを使用します。あなたのデータが、すでにModularityである場合、：
• ModuleCatalog XAMLスキーマー、あるいは、それが、簡単に変換することができる場合、 あなたは、直接、ModuleCatalogを埋め込む、このメソッドを使用することができます。 ConfigurationModuleCatalog内の、IConfigurationStoreを置き換えます。
• あなたが、WPFデスクトップ・アプリケーションを実行する場合、 あなたは、ConfigurationModuleCatalogのためのモジュール項目を返すために、 IConfigurationStoreを実装することができます。
• ModuleCatalogから派生します。また、あなたは、ModuleCatalogから派生するために、 ConfigurationModuleCatalogの例に従うことができます。あなたのデータを取得します。 そして、その次に、カタログを埋め込むために、AddModuleメソッドを呼び出します。

以下のコード例は、ディスクから、カスタム設定モジュール・ファイルを、どのように、読み込むかを示しています。

C#

// Bootstrapper
protected override Microsoft.Practices.Prism.Modularity.IModuleCatalog CreateModuleCatalog()
{
    ConfigurationModuleCatalog catalog = new ConfigurationModuleCatalog();
    catalog.Store = new MyModuleCatalogStore();
    return catalog;
}

C#

// MyModuleCatalogStore
public class MyModuleCatalogStore : IConfigurationStore
    {
        public ModulesConfigurationSection RetrieveModuleConfigurationSection()
        {
            ExeConfigurationFileMap fileMap = new ExeConfigurationFileMap()
            {
                ExeConfigFilename = "MyModuleCatalog.config"
            };
 
            Configuration configuration = ConfigurationManager.OpenMappedExeConfiguration(fileMap, ConfigurationUserLevel.None);
            return configuration.GetSection("modules") as ModulesConfigurationSection;
        }
    }

Retrieving and Loading Modules from a Custom Assembly Source

あなたのアプリケーションが、実装、あるいは、アセンブリ以外の配布の仕組みを持っている場合、 あなたは、型をダウンロードあるは呼び出すために、あなた独自のIModuleTypeLoaderを実装することができます。

Prism 4.1ライブラリのMefXapModuleTypeLoaderクラスは、XAPファイルをダウンロードする、アセンブリを配置する、 そして、それらとMEFカタログを登録するために、MEF DeploymentCatalogを使用する例です。 各々のIModuleTypeLoaderは、モジュールを取得するために使用する、適切な型のローダーを決定するためにModuleManagerを提供する、 CanLoadModuleTypeメソッドを実装しています。次のコード例は、MefXapModuleTypeLoaderの実装を示しています。

C#

// MefXapModuleTypeLoader.cs
public bool CanLoadModuleType(ModuleInfo moduleInfo)
{
    if (moduleInfo == null)
    { 
        throw new ArgumentNullException("moduleInfo"); 
    }
 
    if (!string.IsNullOrEmpty(moduleInfo.Ref))
    {
        Uri uriRef;
        return Uri.TryCreate(moduleInfo.Ref, UriKind.RelativeOrAbsolute, out uriRef);
    }
 
    return false;
}

あなたが、モジュール・データ型ローダーを持ったあと、 あなたは、それが、型ローダーのModuleManagerのコレクションであることを確実にする必要があります。 次のコード例は、Prism.MefExtensions.Silverlightプロジェクトからです。

C#

// MefModuleManager.Silverlight.cs
public override IEnumerable<IModuleTypeLoader> ModuleTypeLoaders
{
    get
    {
        if (this.mefTypeLoaders == null)
        {
            this.mefTypeLoaders = new List<IModuleTypeLoader>()
                                    { this.MefXapModuleTypeLoader };
        }
        return this.mefTypeLoaders;
    }
    set
    {
        this.mefTypeLoaders = value;
    }
}

Changing How Modules Are Initialized

• l ModuleCatalogに加えて、ModuleManagerは、多くの仮想関数を提供します。 それは、モジュールが、どのように、読み込まれて、初期化されるかを変更するために、上書きすることができます。 MefModuleManager内で、いくつかのメソッドを上書きするために、 MEFが必要なModuleManagerで、統合します。いくつかの方法が、ビヘイビアを変更するためにあります：
• l ModuleManagerから派生します。あなたは、モジュールを読み込みと初期化シーケンスの基本的なビヘイビアを変更する必要がある場合、 新しいクラスから派生して、仮想メソッドを上書きします。
• l あなたが、IModuleIntializerを置き換えて、モジュール型が、どのように、インスタンス化、 あるいは、初期化されるか変更する必要がある場合、IModuleIntializerを置き換えます。
• l カスタムIModuleTypeLoaderを記述します。あなたが、アセンブリが、どのように、読み込まれるか、そして、アセンブリ内の、 モジュール型を発見するかを変更する必要がある場合、カスタムIModuleTypeLoaderを記述します。 詳細については、カスタム・アセンブリ・ソースから、モジュールを取得して、読み込む項目(原文)を参照してください。

次のセクションでは、領域が、コントロールに添付されるとき、拡張されることができるPrism Libraryの領域管理が、 どのように、機能するか、どのように、領域が動作するか、そして、領域が、そのViewをどのように発見するか、を説明します。

Creating a Custom Region Adapter

領域として、UIコントロールを公開するために、領域アダプタは使用されます。 領域アダプタは、領域を作成するための、そして、それをコントロールに関連付けるための、役割を果たします。 これを行うことによって、開発者は、IRegionインターフェイスによって、一貫した方法で、UIコントロールの内容を管理することができます。 それぞれの領域アダプタは、UIコントロールのそれぞれの型に合わせます。Prismライブラリは、すぐに使える3つの領域アダプタを提供します。：

• ContentControlRegionAdapter

  このアダプタは、System.Windows.Controls.ContentControl型と派生クラスのコントロールに適応させます。

• SelectorRegionAdapter

  このアダプタは、System.Windows.Controls.TabControlコントロールのような、 System.Windows.Controls.Primitives.Selectorクラスから派生したコントロールに適応させます。

• ItemsControlRegionAdapter

  このアダプタは、System.Windows.Controls.ItemsControl型と派生クラスのコントロールに適応させます。

前述の領域アダプタのどれでもが、開発者の必要に適切ではない、いくつかのシナリオが、あります。 それらの場合において、カスタム領域アダプタは、すぐに使えるPrism Libraryで、 サポートされない、コントロールに適応させために作成することができます。

領域アダプタは、Microsoft.Practices.Prism.Regions.IRegionAdapterインターフェイスを実装します。 このインターフェイスは、適応するために、オブジェクトを取得する、Initializeという名前の、一つのメソッドを定義します。 そして、適応するコントロールで関連付けられる、新しい領域を返します。インタフェース定義は、次のコードで示されます。

C#

public interface IRegionAdapter
{
    IRegion Initialize(object regionTarget, string regionName);
}

領域アダプタを作成するために、あなたは、RegionAdapterBaseからクラスを派生して、 CreateRegionを実装して、メソッドに合わせます。必要に応じて、領域ビヘイビアをカスタマイズするために、 特別なロジックを添付するために、AttachBehaviorsメソッドを上書きします。 あなたが、領域を格納するコントロールと相互作用したい場合、 また、あなたは、IHostAwareRegionBehaviorを実装する必要があります。

CreateRegionメソッドは、RegionAdapterBaseクラスで定義される抽象メソッドです。 それは、適応するコントロールに関連付けるために、（オブジェクトは、IRegionインターフェイスを実装します）領域インスタンスを返します。 Prism Libraryは、すぐに使える、次の領域の実装を提供します。：

• Regions

  この領域は、複数のアクティブViewを提供します。 これは、Selectorクラスから派生したコントロールのために、使用される領域です。

• SingleActiveRegion

  この領域は、一度に、最大1つのアクティブ・ビューを提供します。 これは、ContentControlコントロールのために、使用される領域です。

• AllActiveRegion

  この領域は、その中の、すべてのViewをアクティブに保ちます。 Viewの無効化が許可されていません。これは、ItemsControlコントロールのために、使用される領域です。

また、Adaptメソッドは、RegionAdapterBaseクラスで定義される抽象メソッドです。 それは、以前に作成された領域に適応します。Adaptメソッドは、2つのパラメータを取ります。： コントロールが適応する領域は、関連付けられ、コントロールに適応します。 次のコード例は、ContentControlRegionAdapterを示します。

C#

public class ContentControlRegionAdapter : RegionAdapterBase<ContentControl>
{
    public ContentControlRegionAdapter(IRegionBehaviorFactory regionBehaviorFactory)
        : base(regionBehaviorFactory)
    {
    }

    protected override void Adapt(IRegion region, ContentControl regionTarget)
    {
        if (regionTarget == null) throw new ArgumentNullException("regionTarget");
        bool contentIsSet = regionTarget.Content != null;
        contentIsSet = contentIsSet || (BindingOperations.GetBinding(regionTarget, ContentControl.ContentProperty) != null);

        if (contentIsSet)
        {
            throw new InvalidOperationException(Resources.ContentControlHasContentException);
        }
 
        region.ActiveViews.CollectionChanged += delegate
        {
            regionTarget.Content = region.ActiveViews.FirstOrDefault();
        };
 
        region.Views.CollectionChanged +=
            (sender, e) =>
            {
                if (e.Action == NotifyCollectionChangedAction.Add && region.ActiveViews.Count() == 0)
                {
                    region.Activate(e.NewItems[0]);
                }
            };
    }

    protected override IRegion CreateRegion()
    {
        return new SingleActiveRegion();
    }

}

備考

領域アダプタは、シングルトン・サービスとして登録されます。そして、アプリケーションの寿命を通して生きた状態で保たれます。 それで、あなたが、おそらく、UIコントロールや領域インスタンスのような、短い生きているオブジェクトの参照を維持していないことを確認してください。

正しい領域アダプタを関連付ける、領域マネージャー・サービスで、XAMLが定義する領域のための、領域アダプタ・マッピングが、使用されています。 次の項目は、領域アダプタ・マッピングの登録を、どのように、カスタマイズするかを説明します。

領域アダプタ・マッピングをカスタマイズする

// Bootstrapper.cs
protected virtual RegionAdapterMappings ConfigureRegionAdapterMappings()
{
    RegionAdapterMappings regionAdapterMappings = ServiceLocator.Current.GetInstance<RegionAdapterMappings>();
    if (regionAdapterMappings != null)
    {
        regionAdapterMappings.RegisterMapping(typeof(Selector), ServiceLocator.Current.GetInstance<SelectorRegionAdapter>());
        regionAdapterMappings.RegisterMapping(typeof(ItemsControl), ServiceLocator.Current.GetInstance<ItemsControlRegionAdapter>());
        regionAdapterMappings.RegisterMapping(typeof(ContentControl), ServiceLocator.Current.GetInstance<ContentControlRegionAdapter>());
    }
 
    return regionAdapterMappings;
}

Region Behaviors

領域ビヘイビアは、領域のための機能のほとんどを与えるPrism Libraryで使用されています。ブートストラップ工程の間、ブートストラッパーは、領域ビヘイビアを登録します。 それは、既定で、各々の領域に添付されます。さらに、アダプタは、領域が、特定のコントロール型だけで、関連付けられるとき、ビヘイビアを追加するかもしれません。

すべての領域のための領域ビヘイビアを追加する

protected override IRegionBehaviorFactory ConfigureDefaultRegionBehaviors()
{
    IRegionBehaviorFactory factory = base.ConfigureDefaultRegionBehaviors();
    factory.AddIfMissing("MyBehavior", typeof(MyCustomBehavior));
}

既存の領域ビヘイビアを置き換える

public class MyView : UserControl
{
    public MyView()
    {
        InitializeComponent();

        ObservableObject<IRegion> observableRegion = RegionManager.GetObservableRegion(this.MyRegionHostControl);

        observableRegion.PropertyChanged += (sender, args) => 
        {
            IRegion region = ((ObservableObject<IRegion>)sender).Value;
            region.Behaviors.Add(AutoPopulateBehavior.BehaviorKey, 
                new CustomAutoPopulateBehavior());
        };
    }
}

領域ビヘイビアを削除する

Viewが、どのように、発見されるかを変更する

Changing Your Logical Navigation Structure

Prism Libraryの領域ナビゲーション機能は、ナビゲーション統一リソース識別子 (URI)として、各々のviewの型名を使用します。 あなたのアプリケーションは、View型名から独立した、URIナビゲーション・スキームを公開したいかもしれません。

WPFアプリケーションは、同じ結果を得るために、IRegionNavigationContentLoader実装を置き換えることができます。 また、多標的アプリケーションは、この方法を使用する、アプリケーションのためのURI構造が定義される一つの場所を維持することを望むかもしれません。

論理ナビゲーション構造を変更するために、新しいクラスを派生します。 RegionNavigationContentLoaderとオーバーライドしたGetContractFromNavigationContextメソッドから、 メソッド内で、読み込むView型名を、入力契約名に変換します。それは、基底クラスを呼び出すために、推奨されます。 なぜなら、それは、URIを、検査する契約文字列に、都合良く、解析します。 次のコード例は、カスタム領域のコンテンツ・ローダーを示します。 それは、「Home」をHomeビューに、そして、「About」をAboutビューにマッピングします。

備考

この例では、エクスポート属性は、MEFコンテナで利用できるように、クラスの一番上に、適用して、MEFを使用します。

C#

[Export(typeof(IRegionNavigationContentLoader))]
[PartCreationPolicy(CreationPolicy.Shared)]
public class CustomRegionNavigationContentLoader : RegionNavigationContentLoader
{
    [ImportingConstructor]
    public CustomRegionNavigationContentLoader(IServiceLocator serviceLocator)
        : base(serviceLocator)
    {
    }
 
    protected override string GetContractFromNavigationContext(NavigationContext navigationContext)
    {

        string contract = base.GetContractFromNavigationContext(navigationContext);
 
        if (contract.Equals("Home", StringComparison.OrdinalIgnoreCase))
        {
            return typeof(HomeView).Name;
        }
 
        if (contract.Equals("About", StringComparison.OrdinalIgnoreCase))
        {
            return typeof(AboutView).Name;
        }
 
        return contract;
    }
}

あなたが、カスタム・ナビゲーション・コンテンツ・ローダーを持ったあと、 それを、コンテナ内のIRegionNavigationContentLoaderの実装として、置き換えます。 コンテナ内で、置き換える型の詳細については、このトピックの初めの、コンテナとBootstrapperの項目を参照してください。

Advanced Navigation Replacements

次のセクションでは、Prism Libraryで、提供される領域ナビゲーション基盤構造の主要な部分を置き換えることを説明します。 ほとんどの開発者は、カスタマイズのこのレベルを必要とするシナリオを持っていません。

RegionNavigationContentLoader

IRegionNavigationJournal/IRegionNavigationJournalEntry

IRegionNavigationService

Changing the View Model Locator Conventions

ViewModelLocationProviderは、SetDefaultViewTypeToViewModelTypeResolverと呼び出される静的メソッドを提供します。 それは、ViewModelに、Viewを関連付けるための、あなた独自の規則を提供するために、使用できます。

C#

ViewModelLocationProvider.SetDefaultViewTypeToViewModelTypeResolver((viewType) =>
        {
            ...
            return viewModelType;
        });

既定では、View名前空間に配置される場合、Viewは、ViewModelに名前空間を更新する、 そして、Viewの名前に「ViewModel」接尾辞を添付するでしょう。 Prismは、同じアセンブリで、このViewModelを探すでしょう。

Configuring the ViewModelLocationProvider to Use a Container

次の例は、コンテナを使用して、ViewModelを構築するために、ViewModelLocationProviderを、どのように、設定するかを示します。

あなたのアプリケーションを起動する時、VieModel型を解決するためのあなたのコンテナを使用するために、 SetDefaultViewModelFactoryメソッドを使用します。 以下は、MicrosoftのUnity依存関係注入コンテナを使用する例です。

C#

IUnityContainer _container = new UnityContainer()
...
ViewModelLocationProvider.SetDefaultViewModelFactory((t)=> _container.Resolve(t));        

あなたが、ViewModel内に、既定のコンストラクタを持っている、 そして、注入される依存関係がない場合、ViewModelを作成するための既定の戦略は、 有効なアプローチのActivator.CreateInstanceメソッドを使用することです。