Control.Controls 속성

정의

UI 계층 구조에서 지정된 서버 컨트롤의 자식 컨트롤을 나타내는 ControlCollection 개체를 가져옵니다.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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; }
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

속성 값

지정된 서버 컨트롤에 대한 자식 컨트롤의 컬렉션입니다.The collection of child controls for the specified server control.

특성

예제

다음 예제에서는 Controls 속성을 통해 서버 컨트롤의 ControlCollection 개체에 자식 컨트롤을 추가 하는 방법을 보여 줍니다.The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.

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

설명

ASP.NET 페이지에서 서버 컨트롤의 여는 태그와 닫는 태그 사이에 컨트롤이 선언적으로 추가 되 면 ASP.NET는 해당 컨트롤을 포함 하는 서버 컨트롤의 ControlCollection에 자동으로 추가 합니다.On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's ControlCollection. 서버에서 처리 되지 않는 모든 HTML 태그 또는 텍스트 문자열은 LiteralControl 개체로 처리 됩니다.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. 이러한 컬렉션은 다른 서버 컨트롤과 같이 컬렉션에 추가 됩니다.These are added to the collection like other server controls.

Controls 속성을 사용 하 여 모든 서버 컨트롤의 ControlCollection 클래스 인스턴스에 프로그래밍 방식으로 액세스할 수 있습니다.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. 컬렉션에 컨트롤을 추가 하, 컬렉션에서 컨트롤을 제거 하거나 컬렉션에 있는 서버 컨트롤을 반복할 수 있습니다.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

상속자 참고

Controls 속성을 재정의 하는 경우 EnsureChildControls() 메서드를 호출 해야 합니다.When overriding the Controls property, be sure to call the EnsureChildControls() method. 또한 컨트롤을 프로그래밍 방식으로 컨트롤 컬렉션에 추가할 계획인 경우 재정의 된 CreateChildControls() 메서드에 컨트롤을 추가 하는 것이 좋습니다.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

적용 대상

추가 정보