LiteralControl イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | 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
.NET Framework のセキュリティ継承階層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 プロパティ
パブリック プロパティ.gif)
プロテクト プロパティ.gif)
参照LiteralControl メソッド
パブリック メソッド.gif)
.gif)
プロテクト メソッド.gif)
参照LiteralControl メンバ
HTML 要素、テキスト、およびサーバーでの処理を必要としない ASP.NET ページのその他の文字列を表します。
LiteralControl データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
参照- LiteralControlのページへのリンク
