configSections에 대한 remove 요소(일반 설정 스키마)

아티클
05/27/2012

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

상속된 섹션과 섹션 그룹에 대한 참조를 제거합니다.

<remove 
   name="section name" 
/>

특성 및 요소

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

특성

특성	설명
name	필수 String 특성입니다. 제거할 섹션 또는 섹션 그룹의 이름을 지정합니다. 이 특성은 참조를 추가한 section 요소 또는 sectionGroup 요소의 name 특성과 같습니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
configSections	구성 섹션 및 네임스페이스 선언을 지정합니다.
sectionGroup	구성 섹션 처리기와 구성 섹션 간의 연결을 정의합니다.

설명

remove 요소는 상속된 섹션 또는 섹션 그룹에 대한 참조를 제거합니다. section 및 sectionGroup 요소를 사용하여 현재 구성 파일의 컬렉션에 새 섹션 및 섹션 그룹을 추가할 수 있습니다.

처리기 참조가 제거된 후 구성 파일에서 구성 섹션을 사용하려고 하면 ASP.NET에서 "인식할 수 없는 구성 섹션 element_name입니다."라는 서버 오류 메시지가 나타납니다.

예제

다음 코드 예제에서는 응용 프로그램 구성 파일에서 remove 요소를 사용하여 이전에 Machine.config 파일에 정의된 섹션을 제거하는 방법을 보여 줍니다.

다음 Machine.config 파일 코드는 sampleSection이라는 섹션을 선언합니다.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

다음 예제 응용 프로그램 구성 파일은 sampleSection 섹션을 제거합니다. 이 섹션이 제거되면 응용 프로그램에서는 sampleSection의 설정을 검색할 수 없습니다. 처리기 참조가 제거된 후 구성 파일에서 구성 섹션을 사용하려고 하면 ASP.NET에서 "인식할 수 없는 구성 섹션 element_name입니다."라는 서버 오류 메시지가 나타납니다.

<configuration>
   <configSections>
      <clear/>
      <section name="anotherSection"
               type="System.Configuration.NameValueSectionHandler" />
    </configSections>
</configuration>

요소 정보

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

참고 항목

다음을 통해 공유