Control.Controls 속성

정의

네임스페이스:

System.Web.UI

어셈블리:

System.Web.dll

UI 계층 구조에서 지정된 서버 컨트롤의 자식 컨트롤을 나타내는 ControlCollection 개체를 가져옵니다.

public:
 virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ControlCollection Controls { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection

Public Overridable ReadOnly Property Controls As ControlCollection

속성 값

ControlCollection

지정된 서버 컨트롤에 대한 자식 컨트롤의 컬렉션입니다.

특성

BrowsableAttribute

예제

다음 예제에서는 해당 속성을 통해 서버 컨트롤의 ControlCollection 개체에 자식 컨트롤을 Controls 추가하는 방법을 보여 줍니다.

Controls.Add(new LiteralControl("<h3>Value: "));

Controls.Add(New LiteralControl("<h3>Value: "))
  

설명

ASP.NET 페이지에서 서버 컨트롤의 여는 태그와 닫는 태그 사이에 컨트롤이 선언적으로 추가되면 ASP.NET 포함된 서버 컨트롤의 ControlCollection에 컨트롤을 자동으로 추가합니다. 서버에서 처리되지 않은 HTML 태그 또는 텍스트 문자열은 개체로 LiteralControl 처리됩니다. 다른 서버 컨트롤과 마찬가지로 컬렉션에 추가됩니다.

속성을 Controls 사용하면 모든 서버 컨트롤에 대한 클래스의 인스턴스에 ControlCollection 프로그래밍 방식으로 액세스할 수 있습니다. 컬렉션에 컨트롤을 추가 하, 컬렉션에서 컨트롤을 제거 하거나 컬렉션에 있는 서버 컨트롤을 반복할 수 있습니다.

상속자 참고

속성을 재정의 Controls 할 때 메서드를 호출 EnsureChildControls() 해야 합니다. 또한 컨트롤 컬렉션에 컨트롤을 프로그래밍 방식으로 추가하려는 경우 재정의된 CreateChildControls() 메서드에 컨트롤을 추가하는 것이 좋습니다.

추가 정보

• ControlCollection
• CreateControlCollection()
• CreateChildControls()