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

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

미리 컴파일하는 동안 사용되는 태그 접두사 컬렉션에 태그 접두사를 추가합니다.

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

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

특성 및 요소

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

특성

특성	설명
assembly	선택적 String 특성입니다. COM 컨트롤 구현이 포함된 어셈블리의 이름을 지정하고 namespace 특성도 함께 설정해야 합니다.
namespace	선택적 String 특성입니다. 태그 접두사에 연결되는 네임스페이스를 지정하고, 응용 프로그램 코드 디렉터리에 COM 컨트롤이 없는 경우 assembly 특성도 함께 설정해야 합니다.
src	선택적 String 특성입니다. 사용자 정의 컨트롤이 포함된 파일의 이름을 지정하고 tagName 특성도 함께 설정해야 합니다.
tagName	선택적 String 특성입니다. 페이지에 사용할 컨트롤의 이름을 지정하고 src 특성도 함께 설정해야 합니다.
tagPrefix	필수 String 특성입니다. 소스 파일 또는 네임스페이스와 어셈블리에 매핑되는 태그 접두사를 지정합니다. 이 특성에는 다음과 같은 다른 특성 조합 중 하나가 필요합니다. COM 컨트롤이 응용 프로그램 코드 디렉터리에 있는 경우 이 컨트롤을 정의하는 namespace COM 컨트롤을 정의하는 namespace 및 assembly 사용자 정의 컨트롤을 정의하는 tagName 및 src
상속된 특성	선택적 특성입니다. 모든 section 요소가 상속하는 특성입니다.

자식 요소

없음

부모 요소

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

설명

add 요소는 controls 요소에서 미리 컴파일하는 동안 사용되는 태그 접두사 컬렉션에 태그 접두사를 추가합니다.

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" 
            src="controls/MyControl.ascx"/>
      </controls>
   </pages>

요소 정보

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

참고 항목

다음을 통해 공유