Literal コントロールに表示するキャプションを取得または設定します。
Public Property Text As String
[C#]
public string Text {get; set;}
[C++]
public: __property String* get_Text();public: __property void set_Text(String*);
[JScript]
public function get Text() : String;public function set Text(String);
プロパティ値
Literal コントロールに表示するキャプション。
解説
Text プロパティを使用して、 Literal コントロールに表示するキャプションを決定します。これによって、実行時にキャプションをプログラムで変更できます。
キャプションは、このプロパティへの値の割り当て方法に応じて HTML デコードされます。 Literal コントロールの属性を通じて値を割り当てる場合、この値は表示される前に HTML デコードされます。たとえば、 <asp:Literal id="DisplayLiteral" Text="A B"/> は、ブラウザでは "A B" と表示されます。ただし、プログラムを通じてこのプロパティを設定する場合、またはコントロールの開始タグと終了タグの間にテキストを配置することによって設定する場合は、HTML デコードされません。この場合、 <asp:Literal id="DisplayLiteral"> A B </asp:Literal> は "A B" と表示されます。
注意 このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバー コントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「 検証サーバー コントロール 」を参照してください。
使用例
[Visual Basic, C#] Text プロパティを使用して、 Literal コントロールに表示するキャプションをプログラムで変更する方法を次の例に示します。
<%@ 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>
[C#]
<%@ 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>
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ