ControlCollection クラス

定義

ASP.NET サーバー コントロールが子コントロールのリストを維持できるようにする、コレクション コンテナーを提供します。Provides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

public ref class ControlCollection : System::Collections::ICollection
public class ControlCollection : System.Collections.ICollection
type ControlCollection = class
    interface ICollection
    interface IEnumerable
Public Class ControlCollection
Implements ICollection
継承
ControlCollection
派生
実装

次のコード例ではControl.CreateChildControls 、メソッドをオーバーライドして、という名前のカスタムChildControlクラスのインスタンスの両方で、とMessageいう名前の文字列プロパティを持つ2つのコントロールを作成します。The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. 作成されると、2つのコントロールがControlCollectionに追加されます。When created, the two controls are added to the ControlCollection. メソッドAddは、このバージョンのControl.CreateChildControlsを含むクラスに追加するために、これらの各コントロールで呼び出されます。The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. プロパティChildControlsCreatedは、これらのtrueコントロールが不必要に再作成されないようにに設定されています。The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}

Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub


注釈

ControlCollectionクラスのプロパティとメソッドには、 Control.Controlsプロパティを使用してアクセスできます。You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Controlクラスはすべての ASP.NET サーバーコントロールの基底クラスであるため、すべてのサーバーコントロールはこのプロパティを継承します。Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

コレクションの詳細については、「コレクションとデータ構造」を参照してください。For more information about collections, see Collections and Data Structures.

コンストラクター

ControlCollection(Control)

指定した親サーバー コントロールの ControlCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the ControlCollection class for the specified parent server control.

プロパティ

Count

指定された ASP.NET サーバー コントロールの ControlCollection オブジェクト内にあるサーバー コントロールの数を取得します。Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly

ControlCollection オブジェクトが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized

ControlCollection オブジェクトの同期がとられているかどうかを示す値を取得します。Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32]

ControlCollection オブジェクトの指定されたインデックス位置にあるサーバー コントロールへの参照を取得します。Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner

ControlCollection オブジェクトが属する ASP.NET サーバー コントロールを取得します。Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot

コントロールのコレクションへのアクセスを同期するために使用するオブジェクトを取得します。Gets an object that can be used to synchronize access to the collection of controls.

メソッド

Add(Control)

指定した Control オブジェクトをコレクションに追加します。Adds the specified Control object to the collection.

AddAt(Int32, Control)

指定したインデックス位置に、指定した Control オブジェクトを追加します。Adds the specified Control object to the collection at the specified index location.

Clear()

現在のサーバー コントロールの ControlCollection オブジェクトからすべてのコントロールを削除します。Removes all controls from the current server control's ControlCollection object.

Contains(Control)

指定したサーバー コントロールが親サーバー コントロールの ControlCollection オブジェクト内にあるかどうかを確認します。Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32)

ControlCollection オブジェクトに格納されている子コントロールを、Array オブジェクトに、Array 内の指定したインデックス位置からコピーします。Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetEnumerator()

ControlCollection オブジェクトを反復処理できる列挙子を取得します。Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IndexOf(Control)

コレクション内の指定した Control オブジェクトのインデックスを取得します。Retrieves the index of a specified Control object in the collection.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
Remove(Control)

親サーバー コントロールの ControlCollection オブジェクトから、指定したサーバー コントロールを削除します。Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32)

ControlCollection オブジェクトから、指定したインデックス位置にある子コントロールを削除します。Removes a child control, at the specified index location, from the ControlCollection object.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

拡張メソッド

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください