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

아티클
09/05/2008

업데이트: 2007년 11월

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

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

<clear />

특성 및 요소

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

특성

없음

자식 요소

없음

부모 요소

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

설명

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

처리기 참조가 제거된 후 구성 파일에서 구성 섹션을 사용하려고 하면 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의 설정을 사용할 수 있습니다.

<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

참고 항목

다음을 통해 공유