Control.ClientIDMode 속성

정의

ClientID 속성의 값을 생성하는 데 사용되는 알고리즘을 가져오거나 설정합니다.Gets or sets the algorithm that is used to generate the value of the ClientID property.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

속성 값

ClientID 속성의 생성 방법을 나타내는 값입니다.A value that indicates how the ClientID property is generated. 기본값은 Inherit입니다.The default is Inherit.

특성

예제

다음 예와 Label 에 포함 된 컨트롤을 ListView 제어 합니다.The following example shows Label controls that are contained in a ListView control. ListView 컨트롤에서 ClientIDMode 속성은 Predictable로 설정 되 고 ClientIDRowSuffix 속성은 ProductID로 설정 됩니다.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. 렌더링 된 HTML에서 3 개의 ProductIDLabel 컨트롤에 해당 하는 3 개의 span 요소를 만듭니다.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. 페이지가 실행 될 때 span 요소에 대 한 id 특성은 다음 값으로 설정 됩니다.When the page runs, the id attributes for the span elements are set to the following values:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

설명

ASP.NET는 ClientID 속성 값을 생성 하는 방법에 대 한 여러 알고리즘을 제공 합니다.ASP.NET provides multiple algorithms for how to generate the ClientID property value. ClientIDMode 속성을 설정 하 여 컨트롤에 사용할 알고리즘을 선택 합니다.You select which algorithm to use for a control by setting its ClientIDMode property. 알고리즘은 다음 표에 나열 된 ClientIDMode 열거형 값으로 식별 됩니다.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

Value 설명Description
AutoID 컨트롤의 ClientID 값과 각 부모 명명 컨테이너의 ID 값을 연결하여 ID 값이 생성됩니다.The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. 컨트롤의 여러 인스턴스가 렌더링되는 데이터 바인딩 시나리오에서는 컨트롤의 ID 값 앞에 증분 값이 삽입됩니다.In data-binding scenarios where multiple instances of a control are rendered, an incrementing value is inserted in front of the control's ID value. 각 세그먼트는 밑줄 문자()로 구분됩니다.Each segment is separated by an underscore character (). 이 알고리즘은 ASP.NET 4 이전 버전의 ASP.NET에서 사용 되었습니다.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static ClientID 값은 ID 속성의 값으로 설정되어 있습니다.The ClientID value is set to the value of the ID property. 명명 컨테이너인 컨트롤은 해당 컨트롤에 포함된 모든 컨트롤에 대한 명명 컨테이너 계층의 최상위 컨테이너로 사용됩니다.If the control is a naming container, the control is used as the top of the hierarchy of naming containers for any controls that it contains.
Predictable 이 알고리즘은 데이터 바인딩된 컨트롤에 있는 컨트롤에 사용됩니다.This algorithm is used for controls that are in data-bound controls. 컨트롤의 ClientID 값과 부모 명명 컨테이너의 ClientID 값을 연결하여 ID 값이 생성됩니다.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. 컨트롤이 여러 행을 생성하는 데이터 바인딩된 컨트롤일 경우 ClientIDRowSuffix 속성에 지정된 데이터 필드의 값이 끝에 추가됩니다.If the control is a data-bound control that generates multiple rows, the value of the data field specified in the ClientIDRowSuffix property is added at the end. GridView 컨트롤의 경우 여러 데이터 필드가 지정될 수 있습니다.For the GridView control, multiple data fields can be specified. ClientIDRowSuffix 속성이 비어 있으면 데이터 필드 값 대신 순차적인 숫자가 끝에 추가 됩니다.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data-field value. 이 숫자는 0부터 시작 하 여 각 행에 대해 1 씩 증가 합니다.This number begins at zero and is incremented by 1 for each row. 각 세그먼트는 밑줄 문자()로 구분됩니다.Each segment is separated by an underscore character ().
Inherit 컨트롤은 해당 ClientIDMode 컨트롤의 NamingContainer 설정을 상속합니다.The control inherits the ClientIDMode setting of its NamingContainer control.

페이지의 ClientIDMode 기본값은 Predictable입니다.The default value of ClientIDMode for a page is Predictable. 컨트롤에 대 한 ClientIDMode의 기본값은 Inherit입니다.The default value of ClientIDMode for a control is Inherit. 컨트롤의 기본값은 Inherit이므로 기본 생성 모드는 Predictable입니다.Because the default for controls is Inherit, the default generation mode is Predictable. 그러나 Visual Studio를 사용 하 여 웹 프로젝트를 이전 버전에서 ASP.NET 4로 변환 하는 경우 Visual Studio에서 자동으로 사이트 기본값을 web.config 파일에 AutoID로 설정 합니다.(However, if you use Visual Studio to convert a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the site default to AutoID in the Web.config file.)

자세한 내용은 ASP.NET 웹 서버 컨트롤 식별을 참조하세요.For more information, see ASP.NET Web Server Control Identification.

적용 대상

추가 정보