Localize Web サーバー コントロールの概要
更新 : 2007 年 11 月
Localize Web サーバー コントロールを使用して、ページ上の特定の領域にローカライズされたテキストを表示できます。
このトピックの内容は次のとおりです。
背景
コード例
クラス リファレンス
その他のリソース
背景
Localize コントロールは、Literal Web サーバー コントロールと同じで、Label Web サーバー コントロールと似ています。Label コントロールを使用すると、表示するテキストにスタイルを適用できますが、Localize コントロールではこの操作を行うことはできません。Localize コントロール内に表示されるテキストをプログラムで制御するには、Literal コントロールから継承された Text プロパティを設定します。
コンテンツのエンコーディング
Localize コントロールは、Mode プロパティをサポートしています。このプロパティは、追加されたマークアップをコントロールがどのように処理するかを指定します。Mode プロパティには次の値を設定できます。
Transform コントロールに追加するマークアップは、要求側のブラウザのプロトコルに対応して変換されます。この設定は、HTML 以外のプロトコルを使用するモバイル デバイスにコンテンツを表示する場合に便利です。
PassThrough コントロールに追加するマークアップは、すべてそのままブラウザに表示されます。
Encode コントロールに追加するマークアップは、HTML エンコーディングをテキスト表現に変換する HtmlEncode メソッドを使用してエンコードされます。たとえば、<b> タグは、<b> と表示されます。エンコーディングは、ブラウザにマークアップを解釈させるのではなく表示させる場合に便利です。また、エンコーディングはセキュリティ面でも有用であり、悪意のあるマークアップがブラウザで実行されるのを防止できます。信頼関係のないソースから取得した文字列を表示する場合には、エンコーディングの使用をお勧めします。詳細については、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」を参照してください。
リソース文字列を使用したテキストのローカライズ
ローカライズされた文字列を作成して、Localize コントロールの Text プロパティに表示できます。プロパティの値としては、明示的または暗黙的な式を使用します。式は、リソース (.resx) ファイルに宣言されている文字列を使用して評価されます。
アプリケーションのルートにある App_GlobalResources フォルダと App_LocalResources フォルダに .resx ファイルを作成します。複数の言語の文字列をローカライズする必要がある場合は、ファイル名にロケール情報を含む、追加の .resx ファイルを作成できます。たとえば、フランス語バージョンのリソース ファイルの場合は ExampleLocalizedStrings.fr.resx などの名前にします。
式の詳細については、「ASP.NET 式の概要」を参照してください。リソース ファイルについては、「リソースを使用した ASP.NET Web ページのローカライズ」を参照してください。Localize コントロールで正規表現を使用するコード例については、「Localize Web サーバー コントロールの宣言構文」を参照してください。
ページのトップへ
コード例
方法 : Localize Web サーバー コントロールを ASP.NET Web ページに追加する (Visual Studio)
ページのトップへ
クラス リファレンス
Localize コントロールに関連するクラスの一覧を次の表に示します。
メンバ |
説明 |
|---|---|
コントロールのメイン クラスです。 |
ページのトップへ