アセンブリ検索シーケンス
分離されたアプリケーションでアセンブリの依存関係が指定されている場合、最初に WinSxS フォルダー内の 共有アセンブリ 間でアセンブリが検索されます。 必要なアセンブリが見つからない場合は、アプリケーションのディレクトリ構造のフォルダーにインストールされているプライベート アセンブリを side-by-side で検索します。
プライベート アセンブリ は、アプリケーションのディレクトリ構造内の次の場所に配置できます。
- アプリケーションのフォルダー内。 通常、これはアプリケーションの実行可能ファイルを含むフォルダーです。
- アプリケーションのフォルダー内のサブフォルダー内。 サブフォルダーの名前はアセンブリと同じである必要があります。
- アプリケーションのフォルダー内の言語固有のサブフォルダー内。 サブフォルダーの名前は、言語カルチャまたは言語を示す DHTML 言語コードの文字列です。
- アプリケーションのフォルダー内の言語固有のサブフォルダーのサブフォルダー。 上位のサブフォルダーの名前は、言語カルチャまたは言語を示す DHTML 言語コードの文字列です。 より深いサブフォルダーの名前はアセンブリと同じです。
初めてプライベート アセンブリをサイド バイ サイドで検索すると、アプリケーションのディレクトリ構造に言語固有のサブフォルダーが存在するかどうかを判断します。 言語固有のサブフォルダーが存在しない場合は、次のシーケンスを使用して、次の場所にあるプライベート アセンブリを並べて検索します。
- WinSxS フォルダーを並べて検索します。
- \\<appdir>\<assemblyname>.DLL
- \\<appdir>\<assemblyname.manifest>
- \\<appdir>\<assemblyname>\<assemblyname>.DLL
- \\<appdir>\<assemblyname>\<assemblyname.manifest>
言語固有のサブフォルダーが存在する場合、アプリケーションのディレクトリ構造には、複数の言語でローカライズされたプライベート アセンブリが含まれている可能性があります。 言語固有のサブフォルダーを並べて検索し、アプリケーションで指定された言語または使用可能な最適な言語が使用されていることを確認します。 言語固有のサブフォルダーには、言語カルチャまたは言語を指定する DHTML 言語コードの文字列を使用して名前が付けられます。 言語固有のサブフォルダーが存在する場合は、次のシーケンスを使用して、次の場所にあるプライベート アセンブリを並べて検索します。
- WinSxS フォルダーを並べて検索します。
- \\<appdir>\<language-culture>\<assemblyname>.DLL
- \\<appdir>\<language-culture>\<assemblyname.manifest>
- \\<appdir>\<language-culture>\<assemblyname>\<assemblyname>.DLL
- \\<appdir>\<language-culture>\<assemblyname>\<assemblyname.manifest>
サイド バイ サイド検索シーケンスでは、アセンブリの名前を持つ DLL ファイルが検索され、アセンブリの名前を持つマニフェスト ファイルを検索する前に停止することに注意してください。 DLL であるプライベート アセンブリを処理するには、アセンブリ マニフェストをリソースとして DLL ファイルに配置することをお勧めします。 リソース ID は 1 である必要があり、プライベート アセンブリの名前は DLL の名前と同じにすることができます。 たとえば、DLL の名前がMICROSOFT.WINDOWS.MYSAMPLE.DLLされている場合、アセンブリのマニフェストの assemblyIdentity 要素で使用される name 属性の値も Microsoft.Windows.mysample になります。 別の方法として、アセンブリ マニフェストを別のファイルに配置することもできますが、アセンブリとそのマニフェストの名前は DLL の名前とは異なる必要があります。 たとえば、Microsoft.Windows.mysampleAsm、Microsoft.Windows.mysampleAsm.manifest、MICROSOFT.WINDOWS.MYSAMPLE.DLL。
たとえば、myapp がドライブ c: のルートにインストールされ、フランス語-ベルギー語で myasm が必要な場合、side-by-side は次のシーケンスを使用して、myasm のローカライズされたインスタンスに対する最適な近似を検索します。
- WinSxS で fr-be バージョンを並べて検索します。
- c:\myapp\fr-be\myasm.dll
- c:\myapp\fr-be\myasm.manifest
- c:\myapp\fr-be\myasm\myasm.dll
- c:\myapp\fr-be\myasm\myasm.manifest
- WinSxS で fr バージョンを並べて検索します。
- c:\myapp\fr\myasm.dll
- c:\myapp\fr\myasm.manifest
- c:\myapp\fr\myasm\myasm.dll
- c:\myapp\fr\myasm\myasm.manifest
- WinSxS で en-us バージョンを並べて検索します。
- c:\myapp\en-us\myasm.dll
- c:\myapp\en-us\myasm.manifest
- c:\myapp\en-us\myasm\myasm.dll
- c:\myapp\en-us\myasm\myasm.manifest
- WinSxS で en バージョンを並べて検索します。
- c:\myapp\en\myasm.dll
- c:\myapp\en\myasm.manifest
- c:\myapp\en\myasm\myasm.dll
- c:\myapp\en\myasm\myasm.manifest
- WinSxS で言語なしバージョンを並べて検索します。
- c:\myapp\myasm.dll
- c:\myapp\myasm.manifest
- c:\myapp\myasm\myasm.dll
- c:\myapp\myasm\myasm.manifest
サイド バイ サイド検索がアセンブリの言語に依存しないバージョンに達し、システムに多言語ユーザー インターフェイス (MUI) バージョンの Windows が存在する場合は、side-by-side で assemblyname.mui> に<バインドしようとします。 検索がアセンブリのローカライズされたバージョンに達した場合、<side-by-side は assemblyname.mui> へのバインドを試みません。 言語に依存しない アセンブリのアセンブリ マニフェスト には、 assemblyIdentity 要素に言語属性はありません。 side-by-side が言語に依存しないアセンブリに到達し、MUI がインストールされている場合は、assemblyname.mui> の次のシーケンス<を使用して、次の場所を side-by-side で検索します。 言語が検索されない場合を除き<、アセンブリがカルチャに依存しない>場合は、Side-by-side で同じ検索シーケンスが使用されます。
- WinSxS フォルダーを並べて検索し、assemblyname.mui> を検索<します。
- \\<user's language-culture>\<assemblyname.mui>
- \\<user's language>\<assemblyname.mui>
- \\<system's language-culture>\<assemblyname.mui>
- \\<system's language>\<assemblyname.mui>
- \\<no language>\<assemblyname.mui>
たとえば、side-by-side 検索で c:\myapp\myasm\myasm.manifest でプライベート アセンブリが見つかり、myasm が言語に依存しないアセンブリである場合です。 次に、次のシーケンスを使用して myasm.mui を検索します。 サイド バイ サイドでは、言語に依存しない MUI アセンブリは検索されないことに注意してください。
- WINSxS で MUI アセンブリの fr-be バージョンを並べて検索します。
- c:\myapp\fr-be\myasm.mui.dll
- c:\myapp\fr-be\myasm.mui.manifest
- c:\myapp\fr-be\myasm\myasm.mui.dll
- c:\myapp\fr-be\myasm\myasm.mui.manifest
- WINSxS で MUI アセンブリの fr バージョンを並べて検索します。
- c:\myapp\fr\myasm.mui.dll
- c:\myapp\fr\myasm.mui.manifest
- c:\myapp\fr\myasm\myasm.mui.dll
- c:\myapp\fr\myasm\myasm.mui.manifest
- WinSxS で MUI アセンブリの en-us バージョンを並べて検索します。
- c:\myapp\en-us\myasm.mui.dll
- c:\myapp\en-us\myasm.mui.manifest
- c:\myapp\en-us\myasm\myasm.mui.dll
- c:\myapp\en-us\myasm\myasm.mui.manifest
- WINSxS で MUI アセンブリの en バージョンを並べて検索します。
- c:\myapp\en\myasm.mui.dll
- c:\myapp\en\myasm.mui.manifest
- c:\myapp\en\myasm\myasm.mui.dll
- c:\myapp\en\myasm\myasm.mui.manifest