pages 요소에 대한 controls 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

태그 접두사가 있는 네임스페이스와 register 지시문의 컬렉션을 정의합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<controls> 
   <add /> 
</controls>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

없음

자식 요소

요소	설명
add	선택적 요소입니다. 미리 컴파일하는 동안 사용되는 태그 접두사 컬렉션에 태그 접두사를 추가합니다.

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.
pages	구성 파일 범위에 있는 컨트롤과 페이지에 대해 ASP.NET 지시문과 같은 페이지별 구성 설정을 전역으로 정의합니다.

설명

controls 요소는 태그 접두사가 있는 네임스페이스와 register 지시문의 컬렉션을 정의합니다. 이 요소는 ASP.NET 페이지의 @ Register 지시문에 해당합니다. @ Register 지시문을 사용하면 사용자 정의 컨트롤의 태그 접두사를 지정할 수 있습니다.

태그 접두사는 COM 컨트롤과 사용자 정의 컨트롤이 제대로 동작하기 위해 포함해야 하는 어셈블리와 네임스페이스에 ASP.NET의 네임스페이스를 연결합니다. 다음 정보는 controls 요소를 구성할 때 유용합니다.

사용자 컨트롤에 적용된 경우 add 자식 요소의 tagPrefix, tagName 및 source 특성을 정의해야 합니다.
사용자 지정 컨트롤에 적용된 경우 add 자식 요소의 tagPrefix, namespace 및 assembly 특성을 정의해야 합니다. 컨트롤이 응용 프로그램 코드 디렉터리에 있으면 assembly 특성이 필요하지 않습니다.

동일한 tagPrefix 값을 사용하여 여러 어셈블리 또는 네임스페이스에 매핑할 수 있습니다.

기본 구성

다음의 기본 controls 요소는 루트 Web.config 파일에 구성되어 있습니다.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

예제

다음 코드 예제에서는 프로그래밍 방식으로 TagPrefixInfo 클래스의 멤버로 액세스할 수도 있는 controls 요소의 여러 가지 특성에 대한 값을 선언적으로 지정하는 방법을 보여 줍니다.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

요소 정보

구성 섹션 처리기	PagesSection
구성 멤버	Controls TagPrefixCollection
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목

다음을 통해 공유