Literal クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Literal クラス

静的テキストを表示する Web ページ上の位置を予約します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class Literal
    Inherits Control
    Implements ITextControl

Visual Basic (使用法)

Dim instance As Literal

public class Literal : Control, ITextControl

C++

public ref class Literal : public
 Control, ITextControl

public class Literal extends Control implements
 ITextControl

JScript

public class Literal extends
 Control implements ITextControl

解説

System.Web.UI.WebControls.Literal コントロールを使用して、テキストを表示する Web ページ上の位置を予約します。Literal コントロールは Label コントロールとほぼ同じですが、Literal コントロールでは、表示するテキストにスタイルを適用できないという点が異なります。コントロールに表示するテキストは、Text プロパティを設定することによってプログラムで制御できます。

注意
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバーコントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

注意

このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバーコントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

Topic	Location
チュートリアル : Visual Web Developer での ASP.NET マスタページの作成と使用	Visual Studio での ASP .NET Web アプリケーションの作成
チュートリアル : カスタムビジネスオブジェクトへのデータバインディング	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : ASP.NET Web ページにコントロールをプログラムによって追加する	ASP .NET Web アプリケーションの作成
方法 : Table Web サーバーコントロールに行およびセルを動的に追加する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに Literal Web サーバーコントロールを追加する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに Literal Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : Web フォームページに PlaceHolder Web サーバーコントロールを追加する	ASP .NET Web アプリケーションの作成

使用例

Literal コントロールを使用して静的テキストを表示する方法を次の例に示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ 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>