다음을 통해 공유


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

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

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

<remove 
   name="section name" 
/>

특성 및 요소

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

특성

특성

설명

name

필수 String 특성입니다.

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

자식 요소

없음

부모 요소

요소

설명

configuration

공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.

configSections

구성 섹션 및 네임스페이스 선언을 지정합니다.

sectionGroup

구성 섹션 처리기와 구성 섹션 간의 연결을 정의합니다.

설명

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

처리기 참조가 제거된 후 구성 파일에서 구성 섹션을 사용하려고 하면 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

참고 항목

참조

configSections 요소(일반 설정 스키마)

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

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

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

configuration 요소(일반 설정 스키마)

개념

ASP.NET Configuration File Hierarchy

Format of ASP.NET Configuration Files

Configuration Inheritance

기타 리소스

일반 구성 설정(ASP.NET)

ASP.NET 구성 설정

ASP.NET Configuration Files

Configuring ASP.NET Applications

ASP.NET Configuration API