LiteralControl.CreateControlCollection メソッド

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

LiteralControl.CreateControlCollection メソッド

LiteralControl クラスの現在のインスタンスの EmptyControlCollection オブジェクトを作成します。

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

Visual Basic (宣言)

Protected Overrides Function
 CreateControlCollection As ControlCollection

Visual Basic (使用法)

Dim returnValue As ControlCollection

returnValue = Me.CreateControlCollection

C#

protected override ControlCollection CreateControlCollection ()

C++

protected:
virtual ControlCollection^ CreateControlCollection () override

J#

protected ControlCollection CreateControlCollection ()

JScript

protected override function CreateControlCollection
 () : ControlCollection

戻り値
現在のコントロールの EmptyControlCollection。

解説

既定では、LiteralControl オブジェクトにはテキストだけが格納され、子サーバー コントロールは格納されません。この動作を変更する場合は、このメソッドをオーバーライドする必要があります。

使用例

CreateControlCollection メソッドをオーバーライドして、EmptyControlCollection クラスのインスタンスではなく ControlCollection クラスのインスタンスを作成するコード例を次に示します。

Visual Basic

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
Protected Overrides Function
 CreateControlCollection() As ControlCollection
   myControlCollection = New ControlCollection(Me)
   Return myControlCollection
End Function 'CreateControlCollection

C#

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")] 
protected override ControlCollection CreateControlCollection()
{
   myControlCollection=new ControlCollection(this);
   return myControlCollection;
}

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
LiteralControl クラス
LiteralControl メンバ
System.Web.UI 名前空間
Control.CreateControlCollection
EmptyControlCollection クラス