プロジェクト ファクトリを使用したプロジェクト インスタンスの作成
Visual Studio のプロジェクト タイプでは、"プロジェクト ファクトリ" を使用して、プロジェクト オブジェクトのインスタンスが作成されます。 プロジェクト ファクトリは、共同作成可能な COM オブジェクトの標準クラス ファクトリに似ています。 ただし、プロジェクト オブジェクトは共同作成可能ではありません。これらは、プロジェクト ファクトリを使用してのみ作成できます。
ユーザーが Visual Studio で既存のプロジェクトを読み込むか、新しいプロジェクトを作成するときに、Visual Studio IDE によって、VSPackage に実装されているプロジェクト ファクトリが呼び出されます。 新しいプロジェクト オブジェクトによって、ソリューション エクスプローラーを設定するのに十分な情報が IDE に提供されます。 新しいプロジェクト オブジェクトでは、IDE によって開始された関連するすべての UI 操作をサポートするために必要なインターフェイスも用意されます。
プロジェクト内のクラスに IVsProjectFactory インターフェイスを実装できます。 通常、それは独自のモジュール内に配置されます。
所有者による集計をサポートするプロジェクトは、そのプロジェクト ファイルで所有者キーを永続化する必要があります。 所有者キーを持つプロジェクトで CreateProject メソッドが呼び出されると、所有されているプロジェクトによってその所有者キーがプロジェクト ファクトリ GUID に変換され、その後、このプロジェクト ファクトリで CreateProject メソッドが呼び出され実際の作成が行われます。
所有されているプロジェクトの作成
所有者による所有されているプロジェクトの作成には、次の 2 つのフェーズがあります。
PreCreateForOwner メソッドを呼び出す。 これにより、所有されているプロジェクトには、入力制御
IUnknownに基づいて集計されたプロジェクト オブジェクトを作成する機会が与えられます。 所有されているプロジェクトによって、内部IUnknownおよび集計されたオブジェクトが所有者プロジェクトに渡されます。 これにより、所有されているプロジェクトに、内部IUnknownを格納する機会が与えられます。InitializeForOwner メソッドを呼び出す。 所有されていないプロジェクトの場合のように、
IVsProjectFactory::CreateProjectが呼び出されるのではなく、このメソッドが呼び出されると、所有されているプロジェクトによってすべてのインスタンス化が行われます。 通常、入力VSOWNEDPROJECTOBJECT列挙は、集計された所有されているプロジェクトです。 所有されているプロジェクトでは、この変数を使用して、そのプロジェクト オブジェクトが既に作成されている (cookie が NULL ではない) のか、それとも作成する必要がある (cookie が NULL である) のかを判断できます。プロジェクト タイプは、共同作成可能な COM オブジェクトの CLSID と同様に、一意のプロジェクト GUID によって識別されます。 通常、1 つのプロジェクト ファクトリによって、1 つのプロジェクト タイプのインスタンスの作成が処理されますが、1 つのプロジェクト ファクトリで 1 つ以上のプロジェクト タイプ GUID を処理することもできます。
プロジェクト タイプは、特定のファイル名拡張子に関連付けられています。 ユーザーが既存のプロジェクト ファイルを開こうとしたとき、またはテンプレートを複製して新しいプロジェクトを作成しようとしたとき、IDE によって、ファイルの拡張子が使用され、対応するプロジェクト GUID が特定されます。
IDE によって、新しいプロジェクトを作成する必要があるのか、それとも特定のタイプの既存のプロジェクトを開く必要があるのかが判断されると、[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects] の下にあるシステム レジストリの情報が使用され、必要なプロジェクト ファクトリを実装している VSPackage が検索されます。 この VSPackage が IDE によって読み込まれます。 SetSite メソッドでは、VSPackage によって RegisterProjectType メソッドが呼び出され、そのプロジェクト ファクトリが IDE に登録される必要があります。
IVsProjectFactoryインターフェイスの主要なメソッドは CreateProject です。これは、既存のプロジェクトを開く、新しいプロジェクトを作成するという 2 つのシナリオを処理します。 ほとんどのプロジェクトでは、そのプロジェクトの状態はプロジェクト ファイルに格納されます。 通常、新しいプロジェクトの作成では、CreateProjectメソッドに渡されたテンプレート ファイルのコピーが作成され、そのコピーが開かれます。 既存のプロジェクトは、CreateProjectメソッドに渡されたプロジェクト ファイルを直接開くことによってインスタンス化されます。CreateProjectメソッドでは、必要に応じてユーザーに追加の UI 機能を表示できます。プロジェクトで使用するファイルがないこともあります。その場合、代わりに、そのプロジェクトの状態を、データベースや Web サーバーなどのファイル システム以外のストレージ メカニズムに格納できます。 この場合、プロジェクト データを識別するために、
CreateProjectメソッドに渡されるファイル名パラメーターは、実際は、ファイル システム パスではなく、一意の文字列 (URL) です。CreateProjectに渡されたテンプレート ファイルをコピーして、実行予定の適切な構築シーケンスをトリガーする必要はありません。