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

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

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

LiteralControl クラス

HTML 要素、テキスト、およびサーバーでの処理を必要としない ASP.NET ページのその他の文字列を表します。

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

Visual Basic (宣言)

Public Class LiteralControl
    Inherits Control
    Implements ITextControl

Visual Basic (使用法)

Dim instance As LiteralControl

public class LiteralControl : Control, ITextControl

C++

public ref class LiteralControl : public
 Control, ITextControl

public class LiteralControl extends Control
 implements ITextControl

JScript

public class LiteralControl extends
 Control implements ITextControl

解説

ASP.NET は、すべての HTML 要素およびサーバー側の処理を必要とせずに読み取ることができるテキストを、このクラスのインスタンスにコンパイルします。たとえば、runat="server" の属性と値のペアを開始タグに含んでいない HTML 要素は、LiteralControl オブジェクトにコンパイルされます。LiteralControl オブジェクトはビューステートを保持しないため、LiteralControl オブジェクトの内容は要求ごとに再作成する必要があります。

リテラルコントロールは、テキストホルダとして動作します。つまり、リテラルコントロールからテキストを抽出し、親サーバーコントロールの ControlCollection コレクションから親の Controls プロパティを通じてリテラルコントロールを削除できます。したがって、LiteralControl クラスから派生したカスタムコントロールを開発する場合は、コントロールが LiteralControl.Render メソッドの呼び出しを使用してプリプロセス手順を行うのではなく、コントロール自体が必要なプリプロセス手順を実行するようにします。一般的に、このようにすると、Web アプリケーションの応答時間を短縮できます。

ControlCollection.Add メソッドまたは ControlCollection.Remove メソッドを使用すると、ページコントロールまたはサーバーコントロールからリテラルコントロールをプログラムによって追加または削除できます。

使用例

Control.CreateChildControls メソッドをオーバーライドするときに、オーバーロードされた LiteralControl コンストラクタを使用する方法を次のコード例に示します。このコードでは、2 つの新しい LiteralControl オブジェクトと TextBox Web サーバーコントロールを現在のサーバーコントロールの Control.Controls プロパティに追加します。

Visual Basic

' Add two LiteralControls that render HTML H3 elements and text.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
Protected Overrides Sub
 CreateChildControls()

    Me.Controls.Add(New LiteralControl("<h3>Value:
 "))

    Dim Box As New TextBox
    Box.Text = "0"
    Me.Controls.Add(box)

    Me.Controls.Add(New LiteralControl("</h3>"))
End Sub

// Add two LiteralControls that render HTML H3 elements and text.
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")] 
protected override void CreateChildControls()
 {

    this.Controls.Add(new LiteralControl("<h3>Value:
 "));

    TextBox box = new TextBox();
    box.Text = "0";
    this.Controls.Add(box);

    this.Controls.Add(new LiteralControl("</h3>"));
}

// Add two LiteralControls that render HTML H3 elements and text.
protected void CreateChildControls()
{
    this.get_Controls().Add(new LiteralControl("<h3>Value:
 "));

    TextBox box = new TextBox();
    box.set_Text("0");
    this.get_Controls().Add(box);

    this.get_Controls().Add(new LiteralControl("</h3>"));
} //CreateChildControls