LiteralControl イベント

名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |

LiteralControl クラス
アセンブリ: System.Web (system.web.dll 内)


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 プロパティに追加します。
' 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


System.Web.UI.Control
System.Web.UI.LiteralControl


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


LiteralControl コンストラクタ ()
アセンブリ: System.Web (system.web.dll 内)


LiteralControl クラスを拡張するための CustLiteralControlClass を作成するコード例を次に示します。この例では、LiteralControl オブジェクトのテキストを指定しないコンストラクタを使用して、myLiteralControlClass1 という名前のクラスのインスタンスを作成しています。オブジェクトの作成後、Text プロパティを使用して格納されているテキストを設定します。

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


LiteralControl コンストラクタ

名前 | 説明 |
---|---|
LiteralControl () | 要求された ASP.NET ページに表示されるリテラル文字列を格納している LiteralControl クラスの新しいインスタンスを初期化します。 |
LiteralControl (String) | テキストを指定して、LiteralControl クラスの新しいインスタンスを初期化します。 |

LiteralControl コンストラクタ (String)
アセンブリ: System.Web (system.web.dll 内)


LiteralControl コンストラクタを使用して、LiteralControl クラスの 2 つのインスタンスを作成するコード例を次に示します。2 つのインスタンスは、H3 HTML 要素の開始タグと終了タグをレンダリングし、H3 タグ内に表示されるテキストを挿入します。
' 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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


LiteralControl プロパティ



LiteralControl メソッド



LiteralControl メンバ
HTML 要素、テキスト、およびサーバーでの処理を必要としない ASP.NET ページのその他の文字列を表します。
LiteralControl データ型で公開されるメンバを以下の表に示します。






名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |

- LiteralControlのページへのリンク