Localize クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説Localize コントロールを使用して、ローカライズされたテキストを表示する Web ページ上の位置を予約します。Localize コントロールは Literal コントロールから継承するため、この 2 つのコントロールはすべての点で同一です。デザイン時に Localize コントロールを使用して、ローカライズ可能な静的テキストと他の静的テキストを区別します。Label コントロールを使用すると、表示するテキストにスタイルを適用できますが、Localize コントロールではこれを行うことはできません。コントロールに表示するテキストは、Literal コントロールから継承した Literal.Text プロパティを設定することによってプログラムで管理できます。
.gif) 注意 |
|---|
| このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバー コントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。 |
使用例Localize コントロールを使用して静的テキストを表示する方法を次のコード例に示します。
.gif) メモ |
|---|
| 次のコード例はシングルファイル コード モデルを使用しているため、分離コード ファイルに直接コピーすると正しく動作しない場合があります。このコード例は、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub ButtonClick(ByVal sender As [Object], ByVal e As EventArgs) Localize1.Text = "Welcome to ASP.NET!! This is localized text." End Sub 'ButtonClick </script> </head> <body> <form id="Form1" runat="server"> <h3>Localize Example</h3> <asp:Localize id="Localize1" Text="Hello World!!" runat="server"/> <br><br> <asp:Button id="Button1" Text="Change Localize Text" OnClick="ButtonClick" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void ButtonClick(Object sender, EventArgs e) { Localize1.Text="Welcome to ASP.NET!! This is localized text."; } </script> </head> <body> <form id="Form1" runat="server"> <h3>Localize Example</h3> <asp:Localize id="Localize1" Text="Hello World!!" runat="server"/> <br><br> <asp:Button id="Button1" Text="Change Localize Text" OnClick="ButtonClick" runat="server"/> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.Literal
System.Web.UI.WebControls.Localize
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- Localize クラスのページへのリンク
