다음을 통해 공유

<section> 요소

  • 아티클

구성 섹션 선언을 포함합니다.

<configuration>
  <configSections>
    <section>

<configuration>
  <configSections>
    <sectionGroup>
      <section>

구문

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

필수 특성

Description
name 구성 섹션의 이름을 지정합니다.
type 구성 파일에서 섹션을 읽는 구성 섹션 처리기 클래스의 이름을 지정합니다. 형식 값은 "fully-qualified-section-handler-class-name, simple-assembly-name" 구문을 사용합니다. 간단한 어셈블리 이름은 .dll 파일 확장명 없는 루트 파일 이름입니다.

선택적 특성

다음 특성은 ASP.NET 애플리케이션에만 적용됩니다. 구성 시스템은 다른 애플리케이션 유형에 대해 이러한 특성을 무시합니다.

Description
allowDefinition 섹션을 사용할 수 있는 구성 파일을 지정합니다. 다음 값 중 하나를 사용합니다.

모든 범위
모든 구성 파일에서 섹션을 사용할 수 있습니다. 기본값입니다.
MachineOnly
섹션을 머신 구성 파일(Machine.config)에서만 사용할 수 있습니다.
MachineToApplication
머신 구성 파일 또는 애플리케이션 구성 파일에서 섹션을 사용할 수 있습니다.
allowLocation <location> 요소 내에서 섹션을 사용할 수 있는지 여부를 결정합니다. 다음 값 중 하나를 사용합니다.

true
<location> 요소 내에서 섹션을 사용할 수 있습니다. 기본값입니다.
false
<location> 요소 내에서 섹션을 사용할 수 없습니다.

부모 요소

Description
<configSections> 요소 구성 섹션 및 네임스페이스 선언을 포함합니다.
<sectionGroup> 요소 구성 섹션에 대한 네임스페이스를 정의합니다.

참고

<section> 요소는 <configSections> 또는 <sectionGroup> 중 하나의 자식 요소이지만 둘 다의 자식 요소는 아닙니다.

자식 요소

없음

설명

구성 섹션을 선언하면 기본적으로 구성 파일의 새 요소가 정의됩니다. 새 요소에는 구성 섹션 처리기(즉, IConfigurationSectionHandler 인터페이스를 구현하는 클래스)가 읽는 설정이 포함됩니다. 정의하는 섹션의 특성 및 자식 요소는 설정을 읽는 데 사용하는 섹션 처리기에 따라 달라집니다.

Machine.config 파일에서 구성 섹션 처리기를 선언하면 allowDefinition 특성에 다르게 지정하지 않는 한, 해당 컴퓨터의 애플리케이션 구성 파일에서 구성 섹션을 사용할 수 있습니다.

예제

다음 예제에서는 구성 섹션을 정의하고 해당 섹션에 대한 설정을 정의하는 방법을 보여 줍니다.

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

구성 파일

이 요소는 애플리케이션 디렉터리 수준이 아닌 애플리케이션 구성 파일, 컴퓨터 구성 파일(Machine.config) 및 Web.config 파일에서 사용할 수 있습니다.

참고 항목