Share via


section 요소에서 상속된 일반 특성

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

ASP.NET은 구성 설정을 계층 방식으로 리소스에 적용합니다. 구성 설정은 부모 구성 파일에서 상속됩니다. 이 항목에서는 모든 section 요소에서 상속되는 몇 가지 일반 특성을 보여 줍니다.

Section 요소

Section 요소는 구성 섹션의 멤버입니다. 여기에는 구성 섹션 그룹의 멤버인 요소는 포함되지 않습니다.

구성 섹션 선언은 configSections 요소 내에 있는 구성 파일의 맨 위에 나타납니다. section 요소에 포함되어 있는 각 선언은 섹션 이름과 해당 섹션의 구성 데이터를 처리하는 .NET Framework 클래스(ConfigurationSection에서 파생됨) 이름을 지정합니다. section 태그는 sectionGroup 태그로 그룹화할 수 있습니다.

자세한 내용은 ASP.NET Configuration Files 또는 Format of ASP.NET Configuration Files을 참조하십시오.

일반 특성

다음 표에서는 모든 Section 요소에 설정할 수 있는 일반 특성을 설명합니다. 이러한 일반 특성은 section 요소의 자식 요소에서도 상속됩니다. 이름에 lock이라는 단어가 포함된 모든 특성은 구성 파일의 특정 내용을 변경할 수 없도록 되어 있습니다. 기본적으로 요소 또는 특성은 잠금 해제되어 있습니다.

특성

설명

configSource

선택적 String 특성입니다.

연결된 구성 섹션이 정의된 포함 파일(이러한 파일이 있는 경우)의 이름을 지정합니다. ConfigSource 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

configSource 특성을 사용하는 경우에는 요소 설정을 병합하는 기능이 없으므로 전체 섹션을 별도의 파일로 이동해야 합니다. 기본적으로 외부 파일을 변경하면 응용 프로그램이 다시 시작됩니다. 변경할 때마다 응용 프로그램이 다시 시작되지 않도록 이 동작을 바꾸려면 Web.config 파일에서 configSections에 대한 section 요소(일반 설정 스키마)를 구성하고 restartOnExternalChanges 특성을 false로 설정하면 됩니다.

lockAllAttributesExcept

선택적 String 특성입니다. 이 값은 쉼표로 구분된 목록일 수 있습니다.

부모 요소에서 지정된 특성을 제외하고 모든 특성을 잠급니다.

LockAllAttributesExcept 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

구성 계층 구조의 하위 수준은 계층 구조에서 상위 수준을 잠글 수 없습니다.

lockAllElementsExcept

선택적 String 특성입니다. 이 값은 쉼표로 구분된 목록일 수 있습니다.

부모 요소에서 지정된 요소를 제외하고 모든 자식 요소를 잠급니다.

LockAllElementsExcept 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

lockAttributes

선택적 String 특성입니다. 이 값은 쉼표로 구분된 목록일 수 있습니다.

부모 요소의 모든 특성을 잠급니다.

LockAttributes 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

lockElements

선택적 String 특성입니다. 이 값은 쉼표로 구분된 목록일 수 있습니다.

부모 요소의 모든 자식 요소를 잠급니다.

LockElements 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

lockItem

선택적 String 특성입니다.

특성이 나타나는 요소를 잠가야 하는 경우 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

이 특성을 사용하면 개별 요소를 잠글 수 있을 뿐만 아니라 지정된 컬렉션에서 특정 컬렉션 요소를 잠글 수도 있습니다. 또한 이 특성을 사용하여 전체 섹션을 잠글 수 있습니다.

LockItem 속성을 통해 프로그래밍 방식으로 액세스할 수 있습니다.

예제

다음 코드 예제는 Machine.config 파일의 일부입니다. system.web 섹션 그룹 및 anonymousIdentification 섹션에 대해 구성 섹션 처리기가 선언되어 있습니다. 바로 아래에 system.WebanonymousIdentification 구성 요소가 선언됩니다.

system.Web 구성 요소는 구성 섹션 그룹의 멤버이므로 특성을 포함하지 않습니다.

anonymousIdentification 구성 요소는 구성 섹션의 멤버이므로 위의 표에 나열된 특성을 상속합니다. configSource 특성에는 요소의 내용을 포함할 외부 파일이 할당되어 있으며 lockItem 특성은 내용을 변경할 수 없도록 true로 설정됩니다.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

참고 항목

작업

How to: Lock ASP.NET Configuration Settings

개념

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

Format of ASP.NET Configuration Files

기타 리소스

ASP.NET Configuration Files