ASP.NET アプリケーション内のリソース

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

ASP.NET アプリケーションのサテライトアセンブリを作成した場合は、共通言語ランタイムがこれを見つけて使用できるようにするために、特定の場所に置く必要があります。サテライトアセンブリのディレクトリ構造は、ASP.NET アプリケーションおよび ASP.NET コントロールと、Windows ベースのアプリケーションでは異なります。ASP.NET アプリケーションにはアセンブリを含めることができます。しかし、ASP.NET ページからアセンブリへの変換は動的に実行されるため、アセンブリ名を前もって把握することができず、標準的なサテライトアセンブリ構成も適用されません。ここでは、ASP.NET ページおよび ASP.NET コントロールでリソースを使用する方法を説明します。

メモ :
ASP.NET アプリケーションで使用するためのリソースの作成とコンパイルの手順は、Windows ベースのアプリケーション用のリソースの場合と同じです。手順の詳細については、「リソースファイルの作成」、「リソースのパッケージ化と配置」、および「サテライトアセンブリの作成」を参照してください。

ASP.NET アプリケーションで使用するためのリソースの作成とコンパイルの手順は、Windows ベースのアプリケーション用のリソースの場合と同じです。手順の詳細については、「リソースファイルの作成」、「リソースのパッケージ化と配置」、および「サテライトアセンブリの作成」を参照してください。

ASP.NET ページ内のリソース

ASP.NET ページの中でリソースを使用するには、まず並行メインアセンブリを 1 つ作成して、アプリケーションのリソースを格納します。このアセンブリには、アプリケーション用の既定 (ニュートラル) のリソースが含められます。次に、アプリケーションでサポートするカルチャごとに、ローカライズしたリソースを含むサテライトアセンブリを 1 つずつ作成します。メインアセンブリをアプリケーションの bin ディレクトリ内にインストールし、サテライトアセンブリを適切なサブディレクトリ内にインストールします。

メモ :
このモデルを使用して ASP.NET アプリケーション内にリソースを配置する場合は、生じる可能性があるロック問題を回避するために、すべてのアセンブリがグローバルアセンブリキャッシュへとシャドウコピーされます。

ASP.NET ページに対して次の例を使用すると、適切なリソースを取得する ResourceManager が作成されます。

<%
    Dim a As Assembly = Assembly.Load("myApp")
    Dim rm As ResourceManager = New ResourceManager("myApp", a)
    Response.Write(rm.GetString("string"))
    %>

<%
    Assembly a = Assembly.Load("myApp");
    ResourceManager rm = new ResourceManager("myApp", a);
    Response.Write(rm.GetString("string"));
    %>

.aspx ページ内のリソースを取得するために使用するカルチャを明示的に指定できます。そのためには、前の例に含まれるコード行の後ろに、指定されたカルチャから CultureInfo オブジェクトを作成し、CultureInfo の値を使用して CurrentUICulture プロパティを初期化するコードを続けます。CurrentUICulture プロパティにドイツ語の親カルチャ "de" を設定することで、ドイツ語リソースを常に強制的に取得させる例を次に示します。

Thread.CurrentThread.CurrentUICulture = new CultureInfo("de")

Thread.CurrentThread.CurrentUICulture = new CultureInfo("de");

"de" などのニュートラルカルチャを指定しても、CurrentUICulture プロパティを初期化するために使用できる CultureInfo オブジェクトを作成できますが、CurrentCulture プロパティを初期化するには特定のカルチャを指定する必要があります。CurrentCulture プロパティには、特定のカルチャ、つまりオーストリアのドイツ語と対応する "de-AT" のように、言語と地域の両方に関連付けられたカルチャを指定する必要があります。ニュートラルカルチャ "de" は言語としか関連付けられていないカルチャのため、それだけでは機能しません。CurrentCulture が要求する形式で CultureInfo オブジェクトを作成するには、CultureInfo.CreateSpecificCulture メソッドを使用します。このメソッドは、指定したニュートラルカルチャと関連付けられた特定のカルチャを表す CultureInfo オブジェクトを作成します。CultureInfo.CreateSpecificCulture メソッドを使用することで、ニュートラルカルチャ "de" と関連付けられた特定のカルチャを表す CultureInfo オブジェクトを作成し、それを使用して CurrentCulture プロパティの値を初期化する例を次に示します。

Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("de")

Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("de");

.aspx ページ内で CurrentUICulture プロパティと CurrentCulture プロパティの両方について明示的に値を設定すると便利です。CurrentCulture に "de" を設定し、次に CurrentCulture の値を使用して CurrentUICulture プロパティを初期化する例を次に示します。

Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("de")

Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture

Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("de");

Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture;

CultureInfo.CreateSpecificCulture メソッドを使用すると、Web ブラウザの現在の言語を使用して .aspx ページ内の CurrentCulture プロパティを初期化することもできます。Request.UserLanguages プロパティが Web ブラウザの現在の言語を文字列として返す例を次に示します。CultureInfo.CreateSpecificCulture メソッドは、この文字列を解析してから、CurrentCulture プロパティの値を初期化するために使用できる形式で CultureInfo オブジェクトを返します。

' Set the CurrentCulture property to the culture associated with the Web
' browser's current language setting.
Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(Request.UserLanguages[0])

' It is good practice to explicitly set the CurrentUICulture property.
' Initialize the CurrentUICulture property
' with the CurrentCulture property.
Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture

// Set the CurrentCulture property to the culture associated with the Web
// browser's current language setting.
Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(Request.UserLanguages[0]);

// It is good practice to explicitly set the CurrentUICulture property.
// Initialize the CurrentUICulture property
// with the CurrentCulture property.
Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture;

ASP.NET アプリケーション内でリソースを使用する例については、「方法 : プログラムでリソース値を取得する」チュートリアルおよび ASP.NET クイックスタートにある、ASP.NET アプリケーションのローカライズ方法を示すサンプルや、リソースファイルの使用方法を示すサンプルを参照してください。

ASP.NET コントロール内のリソース

ASP.NET コントロールを使用して ASP.NET アプリケーションを開発した場合は、上記と同じディレクトリ構造を使用できます。コントロールの作成時には、リソースを使用してユーザーに対して各種の情報を使用するコードを記述できます。コントロールはコンパイルされるため、アセンブリを 1 つ持つことになります。したがって、そのアセンブリの中に既定リソースのセットを埋め込むことができます。コントロールが使用するリソース用のサテライトアセンブリを作成し、それをサテライトアセンブリ用のディレクトリ構造の中に配置できます。詳細については、「サテライトアセンブリの作成」を参照してください。コントロールおよびコントロールのリソースをアプリケーションルートの bin ディレクトリ内に配置します。正しいディレクトリ構造の例を次の図に示します。

ASP.NET アプリケーションと ASP.NET コントロールディレクトリ

メイン ASP.NET ディレクトリ、AppRoot として設定

次に示すように、myControl の複数のインスタンスを myPage.aspx に配置できます。バージョンごとに別のリソースファイルエントリを参照するように設定できます。この例を次の ASP.NET コードで示します。

<Loc:myControl runat="server" Text="entry1" />
<Loc:myControl runat="server" Text="entry2" />

この例で、ResourceManager はアプリケーションの CultureInfo.CurrentUICulture プロパティを使用することで、取得するリソースを決定しています。

Button コントロール用の例を次に示します。変数 Text は、これから取得され、後から .aspx ページ内のコントロール内で設定されるプロパティ値を参照しています。この値は、取得するエントリの名前を判断するために使用されます。この例では、同じプロパティを使用することで、ユーザーに対して結果を表示しています。

Public Class myControl
Inherits Button

    Protected Overrides Sub Render(HtmlTextWriter writer)
        ' rm refers to the ResourceManager.
        Text = rm.GetString(Text)
        MyBase.Render(writer)
    End Sub
End Class

public class mycontrol : Button 
{
    protected override void Render(HtmlTextWriter writer) 
    {
        // rm refers to the ResourceManager.
        Text = rm.GetString(Text);      
        base.Render(writer);
    }
}

参照

次の方法で共有

ASP.NET アプリケーション内のリソース

ASP.NET ページ内のリソース

ASP.NET コントロール内のリソース

参照

概念

参照

その他の技術情報

その他のリソース