アセンブリ名

  • [アーティクル]

アセンブリの名前は、メタデータに保存され、アセンブリのスコープに重大な影響があり、アプリケーションによって使用されます。 厳密な名前のアセンブリには、アセンブリの名前、カルチャ、公開キー、バージョン番号、そして必要に応じてプロセッサ アーキテクチャを含む、完全修飾名があります。 読み込まれたアセンブリの完全修飾名 (表示名と呼ばれることが多い) を取得するには、FullName プロパティを使用します。

この名前情報は、該当するアセンブリを検索し、それを同じ名前を持つその他のアセンブリと区別するために、ランタイムによって使用されます。 たとえば、myTypes と呼ばれる厳密な名前のアセンブリは、次の完全修飾名を持つ場合があります。

myTypes, Version=1.0.1234.0, Culture=en-US, PublicKeyToken=b77a5c561934e089c, ProcessorArchitecture=msil

この例の完全修飾名は、myTypes アセンブリには公開キー トークンを持つ厳密な名前があり、英語 (米国) のカルチャの値があり、1.0.1234.0 のバージョン番号があることを示しています。 そのプロセッサ アーキテクチャは msil です。つまり、オペレーティング システムやプロセッサに応じて、32 ビット コードまたは 64 ビット コードに Just-In-Time (JIT) でコンパイルされるということです。

ヒント

ProcessorArchitecture 情報により、プロセッサ固有のバージョンのアセンブリが得られます。 ID のプロセッサ アーキテクチャ (たとえば、32 ビットおよび 64 ビットのプロセッサ固有バージョン) のみが異なる、アセンブリのバージョンを作成できます。 プロセッサ アーキテクチャは、厳密な名前には必要ありません。 詳細については、「AssemblyName.ProcessorArchitecture」を参照してください。

アセンブリの型を要求するコードは、完全修飾のアセンブリ名を使用する必要があります。 これは、完全修飾のバインドと呼ばれます。 アセンブリ名のみを指定する部分的バインドは、.NET Framework のアセンブリを参照している場合は許可されません。

また、.NET Framework を構成するアセンブリへのアセンブリ参照にはすべて、アセンブリの完全修飾名も含める必要があります。 たとえば、バージョン 1.0 の System.Data .NET Framework アセンブリを参照するには、次が含まれます。

System.data, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

このバージョンは、.NET Framework バージョン 1.0 に同梱されているすべての .NET Framework アセンブリのバージョン番号に対応しています。 .NET Framework アセンブリでは、カルチャの値は常にニュートラルであり、公開キーは上記の例に示したものと同じです。

たとえば、トレース リスナーを設定するために、構成ファイルにアセンブリ参照を追加するには、システムの .NET Framework アセンブリの完全修飾名を含めます。

<add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />

注意

アセンブリをバインドするときに、ランタイムは大文字と小文字を区別せずにアセンブリ名を扱いますが、アセンブリ名に使用されている大文字と小文字を保持します。 Windows SDK のいくつかのツールでは、アセンブリ名の大文字小文字を区別して処理します。 最適な結果を得るには、大文字と小文字を区別するものとして、アセンブリ名を管理します。

アプリケーション コンポーネントの名前を指定する

アセンブリの ID を特定するときに、ランタイムではファイル名が考慮されません。 アセンブリ名、バージョン、カルチャ、厳密な名前で構成されるアセンブリ ID は、ランタイムに対して明確である必要があります。

たとえば、myAssembly.dll という名前のアセンブリを参照する myAssembly.exe という名前のアセンブリがある場合は、myAssembly.exe を実行すると、バインドが正しく行われます。 ただし、別のアプリケーションによってメソッド AppDomain.ExecuteAssembly を使用して myAssembly.exe が実行された場合、ランタイムでは、myAssembly.exe で myAssembly へのバインドが要求されるときには、myAssembly は既に読み込まれているものと判断されます。 この場合、myAssembly.dll が読み込まれることはありません。 myAssembly.exe には要求された型が含まれていないため、TypeLoadException が発生します。

この問題を避けるには、アプリケーションを構成するアセンブリが、確実に同じアセンブリ名を持たないように、または異なるディレクトリに同じ名前を持つアセンブリを配置しないようにします。

注意

.NET Framework で、グローバル アセンブリ キャッシュに厳密な名前のアセンブリを配置する場合は、アセンブリのファイル名がアセンブリ名と一致している必要があります ( .exe や .dll などのファイル名拡張子は除きます)。 たとえば、アセンブリのファイル名が myAssembly.dll である場合、アセンブリ名は myAssembly である必要があります。 ルート アプリケーション ディレクトリにのみ展開されるプライベート アセンブリは、ファイル名とは異なるアセンブリ名を持つことができます。

関連項目