アセンブリ登録ツール (Regasm.exe)

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

アセンブリ登録ツールは、1 つのアセンブリに含まれるメタデータを読み込み、必要なエントリをレジストリに追加します。これにより、COM クライアントによって .NET Framework クラスが自動的に作成されます。クラスが登録されると、どの COM クライアントでも、そのクラスを COM クラスであるかのように使用できます。クラスの登録は、アセンブリのインストール時に 1 回だけ行われます。実際に登録されるまでは、アセンブリに含まれるクラスのインスタンスを COM から作成することはできません。

regasm assemblyFile [options]

パラメータ

パラメータ	説明
assemblyFile	COM に登録するアセンブリ。

オプション	説明
/codebase	レジストリに Codebase エントリを作成します。Codebase エントリは、グローバルアセンブリキャッシュにインストールされないアセンブリのファイルパスを指定します。登録しようとしているアセンブリを、後でグローバルアセンブリキャッシュにインストールする場合は、このオプションを指定する必要はありません。/codebase オプションと共に指定する assemblyFile 引数は、厳密な名前付きのアセンブリである必要があります。
/registered	このツールが既に登録されているタイプライブラリだけを参照するように指定します。
/asmpath:directory	アセンブリ参照を含むディレクトリを指定します。/regfile オプションと共に使用する必要があります。
/nologo	Microsoft 著作権情報を表示しません。
/regfile [:regFile]	アセンブリについて指定した .reg ファイルを生成します。このファイルには必要なレジストリエントリが含まれます。このオプションを指定してもレジストリは変更されません。このオプションは /u または /tlb オプションとは併用できません。
/silent または /s	成功メッセージを表示しません。
/tlb [:typeLibFile]	指定したアセンブリからタイプライブラリを生成します。このアセンブリには、アセンブリ内で定義されたアクセス可能な型の定義が含まれます。
/unregister または /u	assemblyFile 内で見つかった、作成可能なクラスの登録を取り消します。このオプションを省略すると、アセンブリ内の作成可能なクラスが Regasm.exe で登録されます。
/verbose	詳細出力モードを指定します。/tlb オプションと共に指定した場合、タイプライブラリを生成する必要のある参照先アセンブリの一覧が表示されます。
/? または /help	このツールのコマンド構文とオプションを表示します。

メモ :
Regasm.exe のコマンド行オプションでは大文字と小文字が区別されません。オプションの一部を指定するだけで一意に識別できます。たとえば、/n は /nologo と等価であり、/t:outfile.tlb は /tlb:outfile.tlb と等価です。

解説

/regfile オプションを使用すると、直接にレジストリを変更しなくても、レジストリエントリを含む .reg ファイルを生成できます。コンピュータのレジストリを更新するには、レジストリエディタツール (Regedit.exe) を使用して .reg ファイルをインポートします。.reg ファイルには、ユーザー定義の登録機能で行われるレジストリの更新についての情報は含まれません。/regfile オプションは、マネージクラスのレジストリエントリだけを生成します。このオプションは、TypeLibID と InterfaceID のエントリは生成しません。

/tlb オプションを指定すると、アセンブリ内で見つかった型を記述するタイプライブラリが Regasm.exe で生成および登録されます。生成されたタイプライブラリは、現在の作業ディレクトリ、または出力ファイル用に指定されたディレクトリ内に格納されます。他のアセンブリを参照するアセンブリについてタイプライブラリを生成すると、一度に複数のタイプライブラリが生成されることがあります。タイプライブラリを使用して、Visual Studio 2005 などの開発用ツールに対して型情報を提供できます。登録するアセンブリがタイプライブラリインポータ (Tlbimp.exe) で生成されたアセンブリである場合には、/tlb オプションを使用しないでください。タイプライブラリからインポートされたアセンブリからは、タイプライブラリをエクスポートできません。/tlb オプションを使用した場合の効果は、タイプライブラリエクスポータ (Tlbexp.exe) と Regasm.exe を使用した場合と同じです。ただし、Tlbexp.exe では、生成されたタイプライブラリが登録されません。/tlb オプションを使用してタイプライブラリを登録する場合、/tlb オプションと /unregister オプションを使用してタイプライブラリの登録を解除できます。この 2 つのオプションを使用すると、タイプライブラリとインターフェイスエントリの登録を解除でき、これによって、レジストリをかなり整理できます。

COM で使用するためにアセンブリを登録すると、Regasm.exe は、ローカルコンピュータのレジストリにエントリを追加します。より具体的には、バージョンに依存するレジストリキーを作成して、同じアセンブリの複数のバージョンが同じコンピュータで side-by-side 実行できるようにします。アセンブリが初めて登録される場合は、そのアセンブリの最上位キーが 1 つ作成され、特定のバージョンに対する一意なサブキーが作成されます。アセンブリの新しいバージョンを登録するたびに、Regasm.exe は、新しいバージョンに対するサブキーを作成します。

たとえば、COM で使用するために、マネージコンポーネント myComp.dll のバージョン 1.0.0.0 を登録しているとします。その後、myComp.dll バージョン 2.0.0.0 を登録します。コンピュータ上のすべての COM クライアントアプリケーションは myComp.dll バージョン 2.0.0.0 を使用しているため、myComponent.dll バージョン 1.0.0.0 を登録解除することにしました。このレジストリスキームでは、myComp.dll バージョン 1.0.0.0 のサブキーだけが削除されるため、バージョン 1.0.0.0 を登録解除できます。

Regasm.exe を使用してアセンブリを登録した後で、そのアセンブリをグローバルアセンブリキャッシュ内に登録すると、どの COM クライアントからもアクティブにできます。アセンブリをアクティブにするアプリケーションが 1 つだけの場合は、そのアプリケーションのディレクトリ内にアセンブリを格納できます。