Literal.Text プロパティ

定義

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 フォーム コード モデルの詳細については、「ASP.NET Web フォーム ページ コード モデル」を参照してください。


<%@ 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&nbsp;B"/> はブラウザーで "A B" としてレンダリングされます。 ただし、このプロパティをプログラムで設定した場合、またはコントロールの開始タグと終了タグの間にテキストを配置した場合、キャプションは HTML デコードされません。 たとえば、 <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> は "A B" としてレンダリングされます。

注意事項

このコントロールは、悪意のあるクライアント スクリプトを含む可能性があるユーザー入力を表示するために使用できます。 クライアントから送信された情報で、実行可能スクリプト、SQL ステートメント、またはその他のコードを確認してから、アプリケーションに表示します。 ASP.NET は、ユーザー入力のスクリプトと HTML をブロックする入力要求検証機能を提供します。 検証サーバー コントロールは、ユーザー入力を評価するためにも提供されます。 詳細については、「 検証サーバーコントロールの構文」を参照してください。

このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、グローバリゼーションとローカライズに関するページを参照してくださいLocalizableAttribute

適用対象

こちらもご覧ください