configSections에 대한 sectionGroup 요소(일반 설정 스키마)
[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]
구성 섹션 처리기와 구성 섹션 간의 연결을 정의합니다.
<sectionGroup
name="section name"
type="configuration section handler class, assembly file name, version, culture, public key token">
<section />
</sectionGroup>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
name |
필수 String 특성입니다. type 특성에 지정된 구성 섹션 처리기와 연결되는 구성 섹션 또는 요소의 이름을 지정합니다. 이 이름은 구성 파일의 섹션 설정 영역에 나타나는 group 요소 이름입니다. |
type |
필수 String 특성입니다. name 특성에 지정된 섹션이나 요소의 구성 설정을 처리하는 구성 섹션 처리기 클래스의 이름을 지정합니다. 다음 형식을 사용합니다. type="정규화된 클래스 이름, 어셈블리 파일 이름, 버전, 문화권, 공개 키 토큰" 정의가 어셈블리 참조와 일치해야 합니다. 예를 들어 다음 코드 예제에서 버전 번호가 어셈블리와 일치하지 않으면 오류가 발생합니다. 어셈블리 파일은 해당 파일을 정의하는 Web.config 파일과 동일한 응용 프로그램 디렉터리에 있어야 합니다. 루트 Web.config 또는 Machine.config 파일의 경우에는 어셈블리 파일이 %SystemRoot%\Microsoft.NET\Framework\version 디렉터리에 있어야 합니다. |
자식 요소
요소 |
설명 |
|---|---|
section |
구성 섹션 처리기와 구성 요소 간의 연결을 정의합니다. |
sectionGroup |
구성 섹션 처리기와 구성 섹션 간의 연결을 정의합니다. |
부모 요소
요소 |
설명 |
|---|---|
configuration |
공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다. |
configSections |
구성 섹션 및 네임스페이스 선언을 지정합니다. |
sectionGroup |
구성 섹션 처리기와 구성 섹션 간의 연결을 정의합니다. |
설명
sectionGroup 요소는 section 요소에 대한 컨테이너 역할을 합니다. section 요소는 구성 섹션 처리기와 구성 요소 또는 섹션을 연결합니다. ASP.NET에서는 구성 파일의 설정을 처리하는 방법에 대해 특정한 가정을 하지 않으므로 이 작업이 필요합니다. 대신 ASP.NET에서는 구성 데이터 처리를 구성 섹션 처리기에 위임합니다. 각 section 요소는 구성 섹션이나 요소 및 이러한 구성 섹션이나 요소를 처리하는 ConfigurationSection 클래스에서 파생된 관련 클래스를 식별합니다. section 요소를 sectionGroup 요소로 논리적으로 그룹화하여 section 요소를 구성하고 이름 충돌 문제를 방지할 수 있습니다. section 요소와 sectionGroup 요소는 configSections 요소에 포함되어 있습니다.
기본 구성
.NET 구성 요소에 대한 구성 섹션은 Machine.config 파일에 정의되어 있으며 너무 많아서 여기에 모두 나열할 수 없습니다. Machine.config 파일에서 발췌한 다음 예제에서는 system.web 섹션의 authentication 요소에 대한 구성 섹션 처리기를 정의합니다. 그 다음에는 authentication 요소에 대해 구성 설정을 정의합니다.
구성 섹션 처리기가 구성 요소와 연결되어 있지 않으면 ASP.NET에서 "인식할 수 없는 구성 섹션 element_name입니다."라는 서버 오류 메시지가 나타납니다.
<configuration>
<configSections>
<sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
<section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
<!-- Other system.web sections -->
</sectionGroup>
<!-- Other configuration sections -->
</configSections>
<system.web>
<authentication mode="Windows">
<forms name=".ASPXAUTH"
loginUrl="login.aspx" defaultUrl="default.aspx"
protection="All"
timeout="30"
path="/"
requireSSL="False"
slidingExpiration="True"
cookieless="UseCookies"
domain=""
enableCrossAppRedirects="False">
<credentials passwordFormat="SHA1" />
</forms>
<passport redirectUrl="internal" />
</authentication>
<!-- Other system.web elements -->
</system.web>
<!-- Other configuration settings -->
</configuration>
예제
다음 코드 예제에서는 섹션 그룹을 선언하고 섹션 그룹 내에서 섹션을 선언하는 방법을 보여 줍니다.
<configuration>
<configSections>
<sectionGroup name="mySectionGroup">
<section name="mySection"
type="System.Configuration.NameValueSectionHandler" />
</sectionGroup>
</configSections>
<mySectionGroup>
<mySection>
<add key="key1" value="value1" />
</mySection>
</mySectionGroup>
</configuration>
요소 정보
구성 섹션 처리기 |
해당 없음 |
구성 멤버 |
|
구성 가능한 위치 |
Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config |
요구 사항 |
Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005 |
참고 항목
참조
configSections에 대한 section 요소(일반 설정 스키마)
configSections에 대한 clear 요소(일반 설정 스키마)
configSections에 대한 remove 요소(일반 설정 스키마)
개념
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files