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합니다.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. 두 컨트롤에 추가 됩니다 만들어지면는 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.

적용 대상

추가 정보