Literal.Text プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Literal コントロールに表示するキャプションを取得または設定します。
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set
Public Property Text As String
プロパティ値
Literal コントロールに表示するキャプション。
実装
- 属性
例
次の例では、プロパティを Text 使用して、コントロールに表示されるキャプションをプログラムで変更する方法を Literal 示します。
注意
次の例では、単一ファイルのコード モデルを使用します。分離コード ファイルに直接コピーすると、正しく動作しない可能性があります。 このコード例は、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。 Web Forms コード モデルの詳細については、「ASP.NET Web Forms ページ コード モデル」を参照してください。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Literal Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form id="form1" 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="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Literal Example</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form id="form1" 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>
注釈
プロパティを Text 使用して、コントロールに表示される Literal キャプションを指定または決定します。 これにより、実行時にプログラムでキャプションを変更できます。
キャプションは、このプロパティに値を割り当てる方法に応じて HTML デコードされます。 コントロールの Literal 属性を使用して値を割り当てる場合、値は表示される前に HTML デコードされます。 たとえば、 <asp:Literal id="DisplayLiteral" Text="A B"/>
ブラウザーでは "A B" としてレンダリングされます。 ただし、このプロパティをプログラムで設定した場合、またはコントロールの開始タグと終了タグの間にテキストを配置した場合、キャプションは HTML デコードされません。 たとえば、 <asp:Literal id="DisplayLiteral"> A B </asp:Literal>
"AB " としてレンダリングされます。
注意事項
このコントロールは、悪意のあるクライアント スクリプトを含む可能性があるユーザー入力を表示するために使用できます。 実行可能スクリプト、SQL ステートメント、またはその他のコードについてクライアントから送信された情報を、アプリケーションに表示する前に確認します。 ASP.NET は、ユーザー入力のスクリプトと HTML をブロックする入力要求検証機能を提供します。 ユーザー入力を評価するための検証サーバー コントロールも用意されています。 詳細については、「 検証サーバーコントロールの構文」を参照してください。
このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、「グローバリゼーションとローカリゼーション」を参照してくださいLocalizableAttribute。