Literal.Text プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文
[LocalizableAttribute(true)] [BindableAttribute(true)] public: virtual property String^ Text { String^ get () sealed; void set (String^ value) sealed; }
/** @property */ public final String get_Text () /** @property */ public final void set_Text (String value)
Literal コントロールに表示するキャプション。
Text プロパティを使用して、Literal コントロールに表示するキャプションを決定します。これによって、実行時にキャプションをプログラムで変更できます。
キャプションは、このプロパティへの値の割り当て方法に応じて HTML デコードされます。Literal コントロールの属性を通じて値を割り当てる場合、この値は表示される前に HTML デコードされます。たとえば、<asp:Literal Text="A B"/> は、ブラウザでは "A B" と表示されます。ただし、プログラムを通じてこのプロパティを設定する場合、またはコントロールの開始タグと終了タグの間にテキストを配置することによって設定する場合は、HTML デコードされません。この場合、<asp:Literal> A B </asp:Literal> は "A B" と表示されます。
注意 |
---|
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバー コントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「検証サーバー コントロール構文」を参照してください。 |
このプロパティの値は、設定時に、デザイナ ツールを使用してリソース ファイルに自動的に保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーション の各トピックを参照してください。
Text プロパティを使用して、Literal コントロールに表示するキャプションをプログラムで変更する方法を次の例に示します。
メモ |
---|
次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub ButtonClick(sender As Object, e As EventArgs) Literal1.Text="Welcome to ASP.NET!!" End Sub </script> </head> <body> <form runat="server"> <h3>Literal Example</h3> <asp:Literal id="Literal1" Text="Hello World!!" runat="server"/> <br><br> <asp:Button id="Button1" Text="Change Literal Text" OnClick="ButtonClick" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void ButtonClick(Object sender, EventArgs e) { Literal1.Text="Welcome to ASP.NET!!"; } </script> </head> <body> <form runat="server"> <h3>Literal Example</h3> <asp:Literal id="Literal1" Text="Hello World!!" runat="server"/> <br><br> <asp:Button id="Button1" Text="Change Literal Text" OnClick="ButtonClick" runat="server"/> </form> </body> </html>
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
LiteralText イベント
パブリック イベント
名前 | 説明 | |
---|---|---|
DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) | |
Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) | |
Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) | |
Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) | |
LoadItems | コントロールの改ページ位置が自動修正され、さらにデータを必要とする場合に発生します。 ( PagedControl から継承されます。) | |
PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) | |
Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
LiteralText クラス
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文
解説
外部のコードが LiteralText クラスのメンバにアクセスするために使用できるのは、新しいデバイス クラス用に作成されたアダプタだけです。そのためアダプタがリテラル テキスト用に作成されている必要があります。
リテラル テキストのレンダリングに使用されるスタイルはデバイスによって異なりますが、リテラル テキストはすべてのデバイス上で表示されます。HTML と WML のどちらを使用していても違いはありません。
-
タグを入れ子にする場合は、ハイパーリンク タグ (アンカー タグ <a>) の内側では、入れ子になったタグが認識されないことに注意してください。たとえば、<a> タグの内側で <b> タグまたは <i> タグをリテラル テキストとして入れ子にした場合、このリンクは太字または斜体としてレンダリングされません。<a> タグの内側のタグは、いずれもコントロールに反映されません。
メモ |
---|
フォームに表示するテキストを動的に設定するには、アダプタで TextView.Text プロパティを使用する必要があります。このような場合、このクラスは使用できません。 |
System.Web.UI.Control
System.Web.UI.MobileControls.MobileControl
System.Web.UI.MobileControls.PagedControl
System.Web.UI.MobileControls.LiteralText
プラットフォーム
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
LiteralText コンストラクタ
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文
プラットフォーム
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
LiteralText プロパティ
パブリック プロパティ
LiteralText メソッド
パブリック メソッド
LiteralText メンバ
フォーム内に指定されたリテラル テキストの実行時インスタンス化を提供します。
LiteralText データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
名前 | 説明 | |
---|---|---|
LiteralText |
名前 | 説明 | |
---|---|---|
DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) | |
Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) | |
Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) | |
Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) | |
LoadItems | コントロールの改ページ位置が自動修正され、さらにデータを必要とする場合に発生します。(PagedControl から継承されます。) | |
PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) | |
Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
- Literal Textのページへのリンク