다음을 통해 공유


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

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

현재 sectionsectionGroup 요소에 추가된 섹션과 섹션 그룹만 허용하고 상속된 섹션과 섹션 그룹에 대한 모든 참조를 제거합니다.

<clear />

특성 및 요소

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

특성

없음

자식 요소

없음

부모 요소

요소

설명

configuration

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

configSections

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

sectionGroup

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

설명

clear 요소는 현재 sectionsectionGroup 요소에 추가된 섹션과 섹션 그룹만 허용하고 상속된 섹션과 섹션 그룹에 대한 모든 참조를 제거합니다.

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

예제

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

Machine.config 파일에서 발췌한 다음 코드에서는 응용 프로그램 구성 파일 전에 읽는 두 개의 섹션, 즉 sampleSection과 anotherSampleSection을 선언합니다.

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

응용 프로그램 구성 파일에서 발췌한 다음 코드는 이전에 선언된 모든 섹션을 지웁니다. 응용 프로그램에서는 Machine.config 파일에 선언된 두 섹션 중 어느 하나에서도 설정을 사용하거나 검색할 수 없습니다. 그러나 anotherSection은 clear 요소 다음에 선언되므로 응용 프로그램에서 anotherSection의 설정을 사용할 수 있습니다.

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

요소 정보

구성 섹션 처리기

해당 없음

구성 멤버

Clear()

Clear()

구성 가능한 위치

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에 대한 remove 요소(일반 설정 스키마)

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