.NET アプリ用のサテライトアセンブリを作成する

[アーティクル]
04/08/2023

リソースファイルはローカライズされたアプリケーションの中心的な役割を果たします。これを使用することで、アプリケーションでは、ユーザーの言語とカルチャで文字列、イメージ、およびその他のデータを表示し、ユーザーの言語またはカルチャ用のリソースが使用できない場合には代替データを提供できるようになります。 .NET ではハブアンドスポークモデルを使用して、ローカライズされたリソースを見つけて取得します。ハブはニュートラルまたは既定のカルチャと呼ばれる、単一カルチャ用のリソースとローカライズできない実行可能コードを含むメインアセンブリです。既定のカルチャはアプリケーションで使用されるフォールバックカルチャです。これは、ローカライズされたリソースが使用できない場合に使用されます。アプリケーションの既定のカルチャにカルチャを指定するために NeutralResourcesLanguageAttribute 属性を使用します。各スポークは、単一のローカライズされたカルチャ用のリソースを含むがコードは含まないサテライトアセンブリに接続します。サテライトアセンブリはメインアセンブリには含まれないため、アプリケーションのメインアセンブリを置換しなくても、特定のカルチャに対応するリソースを簡単に更新または置換できます。

注意

アプリケーションの既定のカルチャのリソースは、サテライトアセンブリにも格納できます。これを行うには、NeutralResourcesLanguageAttribute 属性に UltimateResourceFallbackLocation.Satellite の値を割り当てます。

サテライトアセンブリの名前と場所

ハブアンドスポークモデルでは、簡単に見つけて使用できるように、リソースを特定の場所に配置する必要があります。リソースのコンパイルと名前の指定を適切に行わなかった場合や、リソースを適切な場所に配置しなかった場合、共通言語ランタイムはリソースを見つけることができず、代わりに既定のカルチャのリソースを使用します。 .NET リソースマネージャーは ResourceManager 型によって表され、ローカライズされたリソースに自動的にアクセスするために使われます。リソースマネージャーには次のものが必要です。

単一のサテライトアセンブリには、特定のカルチャ用のリソースをすべて含める必要があります。つまり、複数の .txt ファイルまたは .resx ファイルを単一のバイナリ .resources ファイルにコンパイルする必要があります。
それぞれのローカライズされたカルチャ用のアプリケーションディレクトリに個別のサブディレクトリが必要になります。ここには、そのカルチャのリソースが格納されます。サブディレクトリ名は、カルチャ名と同じである必要があります。グローバルアセンブリキャッシュにサテライトアセンブリを格納することもできます。この場合、アセンブリの厳密な名前のカルチャ情報コンポーネントでそのカルチャを示す必要があります詳細については、「グローバルアセンブリキャッシュにサテライトアセンブリをインストールする」を参照してください。

注意

アプリケーションにサブカルチャ用のリソースを含める場合は、アプリケーションディレクトリの下の個別のサブディレクトリにそれぞれサブカルチャを配置します。メインカルチャのディレクトリの下のサブディレクトリにサブカルチャを配置しないでください。
サテライトアセンブリはアプリケーションと同じ名前を持つ必要があり、ファイル名拡張子として ".resources.dll" を使用する必要があります。たとえば、アプリケーションが Example.exe という名前である場合、各サテライトアセンブリの名前は Example.resources.dll でなければなりません。サテライトアセンブリの名前では、リソースファイルのカルチャは示されていません。ただし、サテライトアセンブリは、カルチャを指定するディレクトリに表示されます。
サテライトアセンブリのカルチャに関する情報は、アセンブリのメタデータに含まれている必要があります。サテライトアセンブリのメタデータにカルチャ名を格納するには、サテライトアセンブリにリソースを埋め込むために Assembly Linker を使用する際に /culture オプションを指定します。

グローバルアセンブリキャッシュ内にインストールしないアプリケーションについて、サンプルのディレクトリ構造と位置に関する要件を次の図に示します。拡張子が .txt および .resources の項目は、最終的なアプリケーションには付属していません。それらは、最終的なサテライトリソースアセンブリを作成するために使用する中間リソースファイルです。この例では、.txt ファイルを .resx ファイルに置き換えることができます。詳細については、リソースのパッケージ化と展開に関するページを参照してください。

次の図は、サテライトアセンブリディレクトリを示しています。

A satellite assembly directory with localized cultures subdirectories.

サテライトアセンブリをコンパイルする

リソースが含まれるテキストファイルまたは XML ( .resx) ファイルをバイナリ .resources ファイルにコンパイルするには、リソースファイルジェネレーター (resgen.exe) を使用します。その後、アセンブリリンカー (al.exe) を使用して、 .resources ファイルをサテライトアセンブリにコンパイルします。 al.exe では、指定した .resources ファイルからアセンブリが作成されます。サテライトアセンブリにはリソースのみを含めることができます。実行可能コードを含めることはできません。

次の al.exe コマンドでは、ドイツ語のリソースファイル strings.de.resources からアプリケーション Example 用のサテライトアセンブリが作成されます。

al -target:lib -embed:strings.de.resources -culture:de -out:Example.resources.dll

また、次の al.exe コマンドでは、ファイル strings.de.resources からアプリケーション Example 用のサテライトアセンブリが作成されます。 /template オプションを指定すると、サテライトアセンブリは親アセンブリ (Example.dll) のカルチャ情報を除き、すべてのアセンブリメタデータを継承します。

al -target:lib -embed:strings.de.resources -culture:de -out:Example.resources.dll -template:Example.dll

次の表では、これらのコマンドで使用する al.exe オプションについてさらに詳しく説明します。

オプション	説明
`-target:lib`	サテライトアセンブリがライブラリ (.dll) ファイルにコンパイルされることを示します。サテライトアセンブリが実行可能コードを含まず、アプリケーションのメインアセンブリではないため、サテライトアセンブリは DLL として保存する必要があります。
`-embed:strings.de.resources`	.exe でのアセンブリのコンパイル時に埋め込むリソースファイルの名前を指定します。サテライトアセンブリに複数の .resources ファイルを埋め込むことはできますが、ハブアンドスポークモデルに従う場合は、カルチャごとに 1 つのサテライトアセンブリをコンパイルする必要があります。ただし、文字列とオブジェクトに対して別の .resources ファイルを作成することができます。
`-culture:de`	コンパイルするリソースのカルチャを指定します。共通言語ランタイムは、指定されたカルチャ用のリソースを検索するときに、この情報を使用します。このオプションを省略しても、al.exe ではリソースがコンパイルされますが、ランタイムではユーザーからの要求時にそれを見つけられなくなります。
`-out:Example.resources.dll`	出力ファイルの名前を指定します。名前は命名標準 baseName.resources.extension に従う必要があります。ここで、baseName はメインアセンブリの名前、extension は有効なファイル名拡張子 (.dll など) です。ランタイムは、出力ファイルの名前でサテライトアセンブリのカルチャを判断できません。/culture オプションを使って指定する必要があります。
`-template:Example.dll`	カルチャフィールドを除く、すべてのアセンブリメタデータをサテライトアセンブリが継承するアセンブリを指定します。このオプションがサテライトアセンブリに影響するのは、厳密な名前を持つアセンブリを指定する場合のみです。

al.exe で使用できるオプションの完全な一覧については、「アセンブリリンカー (al.exe)」を参照してください。

Note

.NET Framework が対象の場合でも、.NET Core の MSBuild タスクを使ってサテライトアセンブリをコンパイルしたい場合があります。たとえば、C# コンパイラの deterministic オプションを使って、さまざまなビルドのアセンブリを比較できます。このような場合は、.csproj ファイルで GenerateSatelliteAssembliesForCore を true に設定して、Al.exe (アセンブリリンカー) ではなく csc.exe を使ってサテライトアセンブリを生成します。

<Project>
    <PropertyGroup>
        <GenerateSatelliteAssembliesForCore>true</GenerateSatelliteAssembliesForCore>
    </PropertyGroup>
</Project>

.NET Core の MSBuild タスクでは、既定で al.exe ではなく csc.exe を使ってサテライトアセンブリが生成されます。詳しくは、「Make it easier to opt into "Core" satellite assembly generation ("Core" サテライトアセンブリの生成を簡単に選択できるようにする)」をご覧ください。

サテライトアセンブリの例

ローカライズされたあいさつ文を含むメッセージボックスを表示する "Hello world" の簡単な例を以下に示します。この例には、英語 (米国)、フランス語 (フランス)、ロシア語 (ロシア) のカルチャ用のリソースが含まれており、そのフォールバックカルチャは英語です。例を作成するには、次の手順を実行します。

既定のカルチャのリソースを含める Greeting.resx または Greeting.txt という名前のリソースファイルを作成します。値が "Hello world!" の HelloString という名前の 1 つの文字列をこのファイルに格納します。
英語 (en) がアプリケーションの既定のカルチャであることを示すには、次の System.Resources.NeutralResourcesLanguageAttribute 属性をアプリケーションの AssemblyInfo ファイル、またはアプリケーションのメインアセンブリにコンパイルされるメインソースコードファイルに追加します。
```
[assembly: NeutralResourcesLanguage("en")]
```
```
<Assembly: NeutralResourcesLanguage("en")>
```
次のように、アプリケーションに他のカルチャ (en-US、fr-FR、および ru-RU) のサポートを追加します。
- en-US、つまり、英語 (米国) カルチャをサポートするには、Greeting.en-US.resx または Greeting.en-US.txt という名前のリソースファイルを作成し、値が "Hi world!" の HelloString という名前の 1 つの文字列をそこに格納します。
- fr-FR、つまり、フランス語 (フランス) カルチャをサポートするには、Greeting.fr-FR.resx または Greeting.fr-FR.txt という名前のリソースファイルを作成し、値が "Salut tout le monde!" の HelloString という名前の 1 つの文字列をそこに格納します。
- ru-RU、つまり、ロシア語 (ロシア) カルチャをサポートするには、Greeting.ru-RU.resx または Greeting.ru-RU.txt という名前のリソースファイルを作成し、値が "Всем привет!" の HelloString という名前の 1 つの文字列をそこに格納します。
resgen.exe を使用して、バイナリ .resources ファイルに各テキストまたは XML リソースファイルをコンパイルします。出力は、 .resx ファイルまたは .txt ファイルと同じルートファイル名を持つファイルセットです。ただし、拡張子は .resources になります。 Visual Studio で例を作成する場合は、コンパイルプロセスが自動的に処理されます。 Visual Studio を使用していない場合は、次のコマンドを実行して .resx ファイルを .resources ファイルにコンパイルします。
```
resgen Greeting.resx
resgen Greeting.en-us.resx
resgen Greeting.fr-FR.resx
resgen Greeting.ru-RU.resx
```
リソースが XML ファイルではなく、テキストファイルにある場合は、 .resx 拡張子を .txt に置き換えます。

アプリケーションのメインアセンブリに、既定のカルチャのリソースと一緒に次のソースコードをコンパイルします。

重要

Visual Studio ではなく、コマンドラインを使用して例を作成する場合は、ResourceManager クラスコンストラクターの呼び出しを ResourceManager rm = new ResourceManager("Greeting", typeof(Example).Assembly); に変更する必要があります。

using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;
using System.Windows.Forms;

class Example
{
   static void Main()
   {
      // Create array of supported cultures
      string[] cultures = {"en-CA", "en-US", "fr-FR", "ru-RU"};
      Random rnd = new Random();
      int cultureNdx = rnd.Next(0, cultures.Length);
      CultureInfo originalCulture = Thread.CurrentThread.CurrentCulture;

      try {
         CultureInfo newCulture = new CultureInfo(cultures[cultureNdx]);
         Thread.CurrentThread.CurrentCulture = newCulture;
         Thread.CurrentThread.CurrentUICulture = newCulture;
         ResourceManager rm = new ResourceManager("Example.Greeting",
                                                  typeof(Example).Assembly);
         string greeting = String.Format("The current culture is {0}.\n{1}",
                                         Thread.CurrentThread.CurrentUICulture.Name,
                                         rm.GetString("HelloString"));

         MessageBox.Show(greeting);
      }
      catch (CultureNotFoundException e) {
         Console.WriteLine("Unable to instantiate culture {0}", e.InvalidCultureName);
      }
      finally {
         Thread.CurrentThread.CurrentCulture = originalCulture;
         Thread.CurrentThread.CurrentUICulture = originalCulture;
      }
   }
}

Imports System.Globalization
Imports System.Resources
Imports System.Threading

Module Module1

    Sub Main()
        ' Create array of supported cultures
        Dim cultures() As String = {"en-CA", "en-US", "fr-FR", "ru-RU"}
        Dim rnd As New Random()
        Dim cultureNdx As Integer = rnd.Next(0, cultures.Length)
        Dim originalCulture As CultureInfo = Thread.CurrentThread.CurrentCulture

        Try
            Dim newCulture As New CultureInfo(cultures(cultureNdx))
            Thread.CurrentThread.CurrentCulture = newCulture
            Thread.CurrentThread.CurrentUICulture = newCulture
            Dim greeting As String = String.Format("The current culture is {0}.{1}{2}",
                                                   Thread.CurrentThread.CurrentUICulture.Name,
                                                   vbCrLf, My.Resources.Greetings.HelloString)

            MsgBox(greeting)
        Catch e As CultureNotFoundException
            Console.WriteLine("Unable to instantiate culture {0}", e.InvalidCultureName)
        Finally
            Thread.CurrentThread.CurrentCulture = originalCulture
            Thread.CurrentThread.CurrentUICulture = originalCulture
        End Try
    End Sub
End Module

アプリケーションが Example という名前で、コマンドラインからコンパイルする場合、C# コンパイラのコマンドは次のようになります。

csc Example.cs -res:Greeting.resources

対応する Visual Basic コンパイラのコマンドは次のようになります。

vbc Example.vb -res:Greeting.resources

アプリケーションでサポートされているそれぞれのローカライズされたカルチャのメインアプリケーションディレクトリに、サブディレクトリを作成します。 en-US、fr-FR、ru-RU サブディレクトリを作成する必要があります。 Visual Studio では、コンパイルプロセスの一環として、これらのサブディレクトリが自動的に作成されます。
個々のカルチャ固有の .resources ファイルをサテライトアセンブリに埋め込み、適切なディレクトリに保存します。各 .resources ファイルでこれを行う場合のコマンドは次のようになります。
```
al -target:lib -embed:Greeting.culture.resources -culture:culture -out:culture\Example.resources.dll
```
ここで、culture はリソースがサテライトアセンブリに含まれるカルチャの名前です。 Visual Studio ではこのプロセスが自動的に処理されます。

その後、例を実行できます。サポートされているカルチャのいずれかがランダムに選択され、現在のカルチャになり、ローカライズされたあいさつ文が表示されます。

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

ローカルアプリケーションサブディレクトリにアセンブリをインストールする代わりに、グローバルアセンブリキャッシュにインストールすることができます。これは、複数のアプリケーションで使用されるクラスライブラリのリソースアセンブリとクラスライブラリがある場合に特に便利です。

アセンブリをグローバルアセンブリキャッシュにインストールするには、アセンブリに厳密な名前が必要です。厳密な名前のアセンブリには、有効な公開/秘密キーのペアで署名されます。これらには、バインド要求を満たすために使用するアセンブリを判別するためにランタイムが使用するバージョン情報が含まれています。厳密な名前とバージョン管理の詳細については、「アセンブリのバージョン管理」を参照してください。厳密な名前の詳細については、「厳密な名前付きアセンブリ」を参照してください。

通常、アプリケーションの開発中に、最終的な公開キーと秘密キーのペアにアクセスすることはありません。サテライトアセンブリをグローバルアセンブリキャッシュ内にインストールし、そのアセンブリが確実に予期したとおりに機能するようにするために、遅延署名と呼ばれる技術を使用できます。アセンブリに遅延署名する場合、厳密な名前による署名のために、ビルド時にファイル内のスペースを予約しておいてください。実際の署名は、最終的な公開/秘密キーのペアが利用可能になるまで遅延されます。遅延署名の詳細については、「アセンブリへの遅延署名」を参照してください。

公開キーを取得する

アセンブリに遅延署名するには、公開キーにアクセスする必要があります。実際の公開キーを取得するには、最終的な署名を行う社内の組織から取得するか、厳密名ツール (sn.exe) を使用して公開キーを作成します。

次の Sn.exe コマンドでは、テスト用の公開/秘密キーのペアを作成します。 –k オプションでは、Sn.exe で新しいキーペアを作成し、TestKeyPair.snk という名前のファイルに格納することが指定されます。

sn –k TestKeyPair.snk

テスト用のキーペアを含むファイルから公開キーを抽出できます。次のコマンドでは、TestKeyPair.snk から公開キーが抽出され、PublicKey.snk に保存されます。

sn –p TestKeyPair.snk PublicKey.snk

アセンブリへの遅延署名

公開キーの取得または作成後に、アセンブリリンカー (al.exe) を使用してアセンブリをコンパイルし、遅延署名を指定します。

次の al.exe コマンドでは、strings.ja.resources ファイルからアプリケーション StringLibrary 用の厳密な名前のサテライトアセンブリが作成されます。

al -target:lib -embed:strings.ja.resources -culture:ja -out:StringLibrary.resources.dll -delay+ -keyfile:PublicKey.snk

/delay+ オプションは、アセンブリリンカーがアセンブリに遅延署名することを指定します。 /keyfile オプションは、アセンブリへの遅延署名のために使用する公開キーを含むキーファイルの名前を指定します。

アセンブリへの再署名

アプリケーションを配置する前に、実際のキーペアで遅延署名されたサテライトアセンブリに再署名する必要があります。これは Sn.exe を使用して行うことができます。

次の Sn.exe コマンドでは、ファイル RealKeyPair.snk に格納されているキーのペアで StringLibrary.resources.dll に署名します。 –R オプションは、以前に署名または遅延署名されたアセンブリに再署名する必要があることを指定します。

sn –R StringLibrary.resources.dll RealKeyPair.snk

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

ランタイムはリソースフォールバックプロセスでリソースを検索するときに、まず、グローバルアセンブリキャッシュ内を調べます (詳細については、リソースのパッケージと展開に関するトピックの「リソースフォールバックプロセス」セクションを参照してください)。サテライトアセンブリは、強力な名前で署名されるとすぐに、グローバルアセンブリキャッシュツール (gacutil.exe) を使用してグローバルアセンブリキャッシュにインストールできます。

次の Gacutil.exe コマンドでは、グローバルアセンブリキャッシュに StringLibrary.resources.dll がインストールされます。

gacutil -i:StringLibrary.resources.dll

/i オプションでは、Gacutil.exe でグローバルアセンブリキャッシュに指定されたアセンブリをインストールする必要があることが指定されます。サテライトアセンブリがキャッシュにインストールされた後、中に含まれるリソースは、サテライトアセンブリを使用するようにデザインされたすべてのアプリケーションで使用できるようになります。

グローバルアセンブリキャッシュのリソース:例

次の例では、.NET のクラスライブラリのメソッドを使って、リソースファイルからローカライズされたあいさつ文を抽出して返します。ライブラリとそのリソースはグローバルアセンブリキャッシュに登録されます。例には、英語 (米国)、フランス語 (フランス)、ロシア語 (ロシア)、および英語カルチャ用のリソースが含まれています。英語は既定のカルチャです。そのリソースはメインアセンブリに格納されます。この例では、最初に公開キーでライブラリとそのサテライトアセンブリに遅延署名してから、公開/秘密キーのペアで再署名します。例を作成するには、次の手順を実行します。

Visual Studio を使用していない場合は、次の厳密名ツール (Sn.exe) コマンドを使って、ResKey.snk という名前の公開キーと秘密キーのペアを作成します。
```
sn –k ResKey.snk
```
Visual Studio を使用している場合は、プロジェクトの [プロパティ] ダイアログボックスの [署名] タブを使用して、キーファイルを生成します。
次の厳密な名前ツール (Sn.exe) コマンドを使用して、PublicKey.snk という名前の公開キーファイルを作成します。
```
sn –p ResKey.snk PublicKey.snk
```
既定のカルチャのリソースを含める Strings.resx という名前のリソースファイルを作成します。値が "How do you do?" の Greeting という名前の 1 つの文字列をそのファイルに格納します。
"en" がアプリケーションの既定のカルチャであることを示すには、次の System.Resources.NeutralResourcesLanguageAttribute 属性をアプリケーションの AssemblyInfo ファイル、またはアプリケーションのメインアセンブリにコンパイルされるメインソースファイルに追加します。
```
[assembly:NeutralResourcesLanguageAttribute("en")]
```
```
<Assembly: NeutralResourcesLanguageAttribute("en")>
```
次のように、アプリケーションに他のカルチャ (en-US、fr-FR および ru-RU カルチャ) のサポートを追加します。
- "en-US"、つまり、英語 (米国) カルチャをサポートするには、Strings.en-US.resx または Strings.en-US.txt という名前のリソースファイルを作成し、値が "Hello!" の Greeting という名前の 1 つの文字列をそのファイルに格納します。
- "fr-FR"、つまり、フランス語 (フランス) カルチャをサポートするには、Strings.fr-FR.resx または Strings.fr-FR.txt という名前のリソースファイルを作成し、値が "Bon jour!" の Greeting という名前の 1 つの文字列をそのファイルに格納します。
- "ru-RU"、つまり、ロシア語 (ロシア) カルチャをサポートするには、Strings.ru-RU.resx または Strings.ru-RU.txt という名前のリソースファイルを作成し、値が "Привет!" の Greeting という名前の 1 つの文字列をそのファイルに格納します。
resgen.exe を使用して、バイナリ .resources ファイルに各テキストまたは XML リソースファイルをコンパイルします。出力は、 .resx ファイルまたは .txt ファイルと同じルートファイル名を持つファイルセットです。ただし、拡張子は .resources になります。 Visual Studio で例を作成する場合は、コンパイルプロセスが自動的に処理されます。 Visual Studio を使用していない場合は、次のコマンドを実行して .resx ファイルを .resources ファイルにコンパイルします。
```
resgen filename
```
ここで、filename は .resx ファイルまたはテキストファイルの省略可能なパス、ファイル名、および拡張子です。

StringLibrary.dll という名前の遅延署名されたライブラリアセンブリに、既定のカルチャのリソースと一緒に StringLibrary.vb または StringLibrary.cs の次のソースコードをコンパイルします。

重要

Visual Studio ではなく、コマンドラインを使用して例を作成する場合は、ResourceManager クラスコンストラクターの呼び出しを ResourceManager rm = new ResourceManager("Strings",typeof(Example).Assembly); に変更する必要があります。

using System;
using System.Globalization;
using System.Reflection;
using System.Resources;
using System.Threading;

[assembly:NeutralResourcesLanguageAttribute("en")]

public class StringLibrary
{
   public string GetGreeting()
   {
      ResourceManager rm = new ResourceManager("Strings",
                           Assembly.GetAssembly(typeof(StringLibrary)));
      string greeting = rm.GetString("Greeting");
      return greeting;
   }
}

Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading

<Assembly: NeutralResourcesLanguageAttribute("en")>

Public Class StringLibrary
    Public Function GetGreeting() As String
        Dim rm As New ResourceManager("Strings", _
                                      Assembly.GetAssembly(GetType(StringLibrary)))
        Dim greeting As String = rm.GetString("Greeting")
        Return greeting
    End Function
End Class

C# コンパイラのコマンドは次のようになります。

csc -t:library -resource:Strings.resources -delaysign+ -keyfile:publickey.snk StringLibrary.cs

対応する Visual Basic コンパイラのコマンドは次のようになります。

vbc -t:library -resource:Strings.resources -delaysign+ -keyfile:publickey.snk StringLibrary.vb

アプリケーションでサポートされているそれぞれのローカライズされたカルチャのメインアプリケーションディレクトリに、サブディレクトリを作成します。 en-US、fr-FR、ru-RU サブディレクトリを作成する必要があります。 Visual Studio では、コンパイルプロセスの一環として、これらのサブディレクトリが自動的に作成されます。すべてのサテライトアセンブリが同じファイル名を持つため、公開キーと秘密キーのペアで署名されるまで個々のカルチャ固有のサテライトアセンブリを格納するためにはサブディレクトリが使用されます。
個々のカルチャ固有の .resources ファイルを遅延署名されたサテライトアセンブリに埋め込み、適切なディレクトリに保存します。各 .resources ファイルでこれを行う場合のコマンドは次のようになります。
```
al -target:lib -embed:Strings.culture.resources -culture:culture -out:culture\StringLibrary.resources.dll -delay+ -keyfile:publickey.snk
```
ここで、culture はカルチャの名前です。この例では、カルチャ名は en-US、fr-FR、および ru-RU です。
次のように、厳密名ツール (sn.exe) を使用して、StringLibrary.dll に再署名します。
```
sn –R StringLibrary.dll RealKeyPair.snk
```
個々のサテライトアセンブリに再署名します。これを行うには、各サテライトアセンブリに対して、次のように厳密名ツール (sn.exe) を使用します。
```
sn –R StringLibrary.resources.dll RealKeyPair.snk
```
次のコマンドを使用して、グローバルアセンブリキャッシュに StringLibrary.dll とそのサテライトアセンブリをそれぞれ登録します。
```
gacutil -i filename
```
ここで、filename は登録するファイルの名前です。

Visual Studio を使用している場合は、Example という名前の新しいコンソールアプリケーション プロジェクトを作成し、StringLibrary.dll への参照と次のソースコードを追加してコンパイルします。

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      string[] cultureNames = { "en-GB", "en-US", "fr-FR", "ru-RU" };
      Random rnd = new Random();
      string cultureName = cultureNames[rnd.Next(0, cultureNames.Length)];
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName);
      Console.WriteLine("The current UI culture is {0}",
                        Thread.CurrentThread.CurrentUICulture.Name);
      StringLibrary strLib = new StringLibrary();
      string greeting = strLib.GetGreeting();
      Console.WriteLine(greeting);
   }
}

Imports System.Globalization
Imports System.Threading

Module Example
    Public Sub Main()
        Dim cultureNames() As String = {"en-GB", "en-US", "fr-FR", "ru-RU"}
        Dim rnd As New Random()
        Dim cultureName As String = cultureNames(rnd.Next(0, cultureNames.Length))
        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName)
        Console.WriteLine("The current UI culture is {0}",
                          Thread.CurrentThread.CurrentUICulture.Name)
        Dim strLib As New StringLibrary()
        Dim greeting As String = strLib.GetGreeting()
        Console.WriteLine(greeting)
    End Sub
End Module

コマンドラインからコンパイルするには、C# コンパイラの次のコマンドを使用します。

csc Example.cs -r:StringLibrary.dll

Visual Basic コンパイラのコマンドラインは次のとおりです。

vbc Example.vb -r:StringLibrary.dll

Example.exe を実行します。

.NET アプリ用のサテライトアセンブリを作成する

サテライトアセンブリの名前と場所

サテライトアセンブリをコンパイルする

サテライトアセンブリの例

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

公開キーを取得する

アセンブリへの遅延署名

アセンブリへの再署名

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

グローバルアセンブリキャッシュのリソース:例

関連項目

フィードバック

その他のリソース

.NET アプリ用のサテライト アセンブリを作成する

サテライト アセンブリの名前と場所

サテライト アセンブリをコンパイルする

サテライト アセンブリの例

グローバル アセンブリ キャッシュにサテライト アセンブリをインストールする

公開キーを取得する

アセンブリへの遅延署名

アセンブリへの再署名

グローバル アセンブリ キャッシュにサテライト アセンブリをインストールする

グローバル アセンブリ キャッシュのリソース:例

関連項目

フィードバック

その他のリソース

.NET アプリ用のサテライトアセンブリを作成する

サテライトアセンブリの名前と場所

サテライトアセンブリをコンパイルする

サテライトアセンブリの例

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

グローバルアセンブリキャッシュにサテライトアセンブリをインストールする

グローバルアセンブリキャッシュのリソース:例