方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する

[アーティクル]
05/10/2023

.NET Framework ベースのコンポーネントの登録を必要としないアクティベーションは、COM コンポーネントの場合よりも少しだけ複雑です。セットアップには 2 つのマニフェストが必要です。

COM アプリケーションには、マネージドコンポーネントを識別するための Win32 スタイルのアプリケーションマニフェストが必要です。
.NET Framework ベースのコンポーネントには、実行時に必要なアクティベーション情報のコンポーネントマニフェストが必要です。

このトピックでは、アプリケーションマニフェストをアプリケーションに関連付ける方法、コンポーネントマニフェストをコンポーネントに関連付ける方法、およびコンポーネントマニフェストをアセンブリに埋め込む方法について説明します。

アプリケーションマニフェストを作成する

XML エディターを使用して、1 つ以上のマネージドコンポーネントと相互運用する COM アプリケーションによって所有されるアプリケーションマニフェストを作成または編集します。
ファイルの先頭に次の標準ヘッダーを挿入します。
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
</assembly>
```
マニフェストの要素とその属性については、「Application Manifests」(アプリケーションマニフェスト) をご覧ください。

マニフェストの所有者を指定します。次の例では、myComApp バージョン 1 がマニフェストファイルを所有しています。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32"
                    name="myOrganization.myDivision.myComApp"
                    version="1.0.0.0"
                    processorArchitecture="msil"
  />
</assembly>

依存アセンブリを指定します。 myComApp が myManagedComp に依存する例を次に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32"
                    name="myOrganization.myDivision.myComApp"
                    version="1.0.0.0"
                    processorArchitecture="x86"
                    publicKeyToken="8275b28176rcbbef"
  />
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32"
                    name="myOrganization.myDivision.myManagedComp"
                    version="6.0.0.0"
                    processorArchitecture="X86"
                    publicKeyToken="8275b28176rcbbef"
      />
    </dependentAssembly>
  </dependency>
</assembly>

マニフェストファイルに名前を付けて保存します。アプリケーションマニフェストの名前は、アセンブリ実行可能ファイルの名前に拡張子 .manifest が付いたものです。たとえば、myComApp.exe のアプリケーションマニフェストファイル名は myComApp.exe.manifest です。

アプリケーションマニフェストは、COM アプリケーションと同じディレクトリにインストールできます。また、アプリケーションの .exe ファイルにリソースとして追加することもできます。詳しくは、「side-by-side アセンブリについて」をご覧ください。

コンポーネントマニフェストを作成する

XML エディターを使用して、マネージドアセンブリを記述するコンポーネントマニフェストを作成します。

ファイルの先頭に次の標準ヘッダーを挿入します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
</assembly>

ファイルの所有者を指定します。アプリケーションマニフェストファイル内の <assemblyIdentity> 要素の <dependentAssembly> 要素は、コンポーネントマニフェスト内の要素と一致している必要があります。次の例では、myManagedComp バージョン 1.2.3.4 がマニフェストファイルを所有しています。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
       <assemblyIdentity
                    name="myOrganization.myDivision.myManagedComp"
                    version="1.2.3.4"
                    publicKeyToken="8275b28176rcbbef"
                    processorArchitecture="msil"
       />
</assembly>

アセンブリ内の各クラスを指定します。マネージドアセンブリ内の各クラスを一意に識別するには <clrClass> 要素を使用します。この要素は、<assembly> 要素のサブ要素であり、次の表に示す属性を持っています。

属性	説明	必須
`clsid`	アクティブにするクラスを指定する識別子。	はい
`description`	ユーザーにコンポーネントを説明する文字列。既定では文字列は空です。	いいえ
`name`	マネージドクラスを表す文字列。	はい
`progid`	遅延バインディングによるアクティベーションで使用される識別子。	いいえ
`threadingModel`	COM スレッドモデル。 "Both" が既定値です。	いいえ
`runtimeVersion`	使用する共通言語ランタイム (CLR: Common Language Runtime) のバージョンを指定します。この属性を指定せず、CLR がまだ読み込まれていない場合は、インストールされている最新の CLR (CLR Version 4 よりも前のバージョン) でコンポーネントが読み込まれます。 v1.0.3705、v1.1.4322、または v2.0.50727 を指定すると、インストールされている最新の CLR バージョン (CLR Version 4 よりも前のバージョン。通常は v2.0.50727) に自動的にロールフォワードされます。別のバージョンの CLR が既に読み込まれていて、指定されたバージョンをインプロセスで並行して (side-by-side で) 読み込むことができる場合は、指定されたバージョンが読み込まれます。それ以外の場合は、読み込まれた CLR が使用されます。これにより、読み込みエラーが発生する可能性があります。	いいえ
`tlbid`	クラスに関する型情報を格納するタイプライブラリの識別子。	いいえ

属性タグはすべて大文字と小文字が区別されます。 OLE/COM オブジェクトビューアー (Oleview.exe) で、エクスポートされたアセンブリのタイプライブラリを表示することによって、CLSID、ProgID、スレッドモデル、およびランタイムのバージョンを取得できます。

testClass1 および testClass2 という 2 つのクラスを識別するコンポーネントマニフェストを次に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
       <assemblyIdentity
                    name="myOrganization.myDivision.myManagedComp"
                    version="1.2.3.4"
                    publicKeyToken="8275b28176rcbbef"
       />
       <clrClass
                    clsid="{65722BE6-3449-4628-ABD3-74B6864F9739}"
                    progid="myManagedComp.testClass1"
                    threadingModel="Both"
                    name="myManagedComp.testClass1"
                    runtimeVersion="v1.0.3705">
       </clrClass>
       <clrClass
                    clsid="{367221D6-3559-3328-ABD3-45B6825F9732}"
                    progid="myManagedComp.testClass2"
                    threadingModel="Both"
                    name="myManagedComp.testClass2"
                    runtimeVersion="v1.0.3705">
       </clrClass>
       <file name="MyManagedComp.dll">
       </file>
</assembly>

マニフェストファイルに名前を付けて保存します。コンポーネントマニフェストの名前は、アセンブリライブラリの名前に拡張子 .manifest が付いたものです。たとえば、myManagedComp.dll の場合は、myManagedComp.manifest になります。

コンポーネントマニフェストはリソースとしてアセンブリに埋め込む必要があります。

コンポーネントマニフェストをマネージドアセンブリに埋め込むには

次のステートメントを含むリソーススクリプトを作成します。

1 RT_MANIFEST myManagedComp.manifest

このステートメントで、myManagedComp.manifest は埋め込むコンポーネントマニフェストの名前です。この例では、スクリプトファイル名は myresource.rc です。
Microsoft Windows リソースコンパイラ (Rc.exe) を使用してスクリプトをコンパイルします。コマンドプロンプトに次のコマンドを入力します。

rc myresource.rc

Rc.exe は myresource.res リソースファイルを生成します。
もう一度アセンブリのソースファイルをコンパイルし、 /win32res オプションを使用してリソースファイルを指定します。

/win32res:myresource.res

ここでも、myresource.res は埋め込むリソースを含むリソースファイルの名前です。

方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する

アプリケーションマニフェストを作成する

コンポーネントマニフェストを作成する

コンポーネントマニフェストをマネージドアセンブリに埋め込むには

関連項目

フィードバック

その他のリソース

方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する

アプリケーション マニフェストを作成する

コンポーネント マニフェストを作成する

コンポーネント マニフェストをマネージド アセンブリに埋め込むには

関連項目

フィードバック

その他のリソース

アプリケーションマニフェストを作成する

コンポーネントマニフェストを作成する

コンポーネントマニフェストをマネージドアセンブリに埋め込むには