ControlCollection ControlCollection ControlCollection ControlCollection Class

定義

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
継承
ControlCollectionControlCollectionControlCollectionControlCollection
派生
実装

次のコード例の上書き、 Control.CreateChildControls 2 つのコントロール、という名前のカスタム クラスの両方のインスタンスを作成するメソッドをChildControl、という名前の文字列プロパティを持つMessageします。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 'CreateChildControls


注釈

すべてのプロパティとメソッドにアクセスすることができます、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(Control) ControlCollection(Control) ControlCollection(Control)

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

プロパティ

Count Count Count Count

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

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

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

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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

Owner Owner Owner Owner

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

SyncRoot SyncRoot SyncRoot SyncRoot

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

メソッド

Add(Control) Add(Control) Add(Control) Add(Control)

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

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

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

Clear() Clear() Clear() Clear()

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

Contains(Control) Contains(Control) Contains(Control) Contains(Control)

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

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

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

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

適用対象

こちらもご覧ください