Literal.Text プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

プロパティ値

String

Literal コントロールに表示するキャプション。

実装

Text
属性
BindableAttribute

例

次の例では、 プロパティを 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。

適用対象

こちらもご覧ください