사용자 지정 섹션 처리기를 만드는 데 사용되는 클래스
업데이트: 2007년 11월
기존 구성 섹션 중 요구에 맞는 섹션이 없으면 사용자 지정 섹션을 만들고 구성 데이터를 읽고 쓰도록 처리기를 구현할 수 있습니다. 처리기는 ConfigurationSection 클래스를 확장하는 .NET Framework 클래스여야 합니다.
참고: |
---|
.NET Framework 버전 1.0 및 1.1에서는 구성 섹션 처리기가 IConfigurationSectionHandler 인터페이스를 구현해야 하며, 이 인터페이스는 .NET Framework 버전 2.0에서도 지원되었으나 이제는 사용되지 않습니다. |
사용자 지정 섹션 처리기는 두 가지 구현 모델인 프로그래밍 모델과 선언적 모델 중 하나를 사용하여 구현할 수 있습니다.
프로그래밍 구현 모델
이 모델을 사용하려면 각 섹션 특성마다 속성을 만들어 값을 가져오거나 설정하고 내부 ConfigurationElement 기본 클래스의 내부 속성 컬렉션에 추가해야 합니다.
선언적 구현 모델
특성 모델이라고도 하는 이 모델을 사용하면 속성 및 설정 특성을 통해 섹션 특성을 정의할 수 있습니다. 이 특성은 ASP.NET 구성 시스템에 속성 형식과 기본값에 대한 정보를 알려 줍니다. ASP.NET 구성 시스템에서는 리플렉션을 통해 가져오는 이 정보를 사용하여 섹션 속성 개체를 만들고 필요한 초기화를 수행합니다. 리플렉션에 대한 자세한 내용은 리플렉션 개요를 참조하십시오.
사용자 지정 섹션 처리기를 만드는 데 사용되는 클래스
다음 표에서는 프로그래밍 방식으로 사용자 지정 섹션 처리기를 만드는 데 사용되는 클래스를 보여 줍니다.
각 클래스 항목에는 구현 모델 중 하나 또는 모두를 사용하는 자세한 코드 예제가 있습니다. 또한 방법: ConfigurationSection을 사용하여 사용자 지정 구성 섹션 만들기에서 단순화된 선언적 코드 예제를 볼 수 있습니다.
섹션 처리기 구현에 사용되는 클래스 |
설명 |
---|---|
구성 파일 내의 섹션을 나타냅니다. ConfigurationSection을 사용하여 사용자 지정 섹션 처리기 형식을 구현할 수 있으며, ConfigurationSection 클래스를 확장하여 사용자 지정 처리 및 사용자 지정 구성 섹션에 대한 프로그래밍 액세스를 제공할 수 있습니다. 섹션에서는 구성 파일의 configSections 요소에 있는 항목을 사용하여 처리 형식을 등록합니다. |
|
구성 파일 내에서 관련 섹션의 컬렉션을 나타냅니다. ConfigurationSection 클래스를 확장하는 사용자 지정 형식을 만들 때 ConfigurationSectionCollection을 사용합니다. 또한 ConfigurationSection 개체의 컬렉션을 통해 프로그래밍 방식으로 구성 파일을 읽을 때 사용합니다. |
|
구성 파일 내 요소의 컬렉션을 나타냅니다. ConfigurationElement 개체의 컬렉션에 대한 작업을 할 때 ConfigurationElementCollection을 사용합니다. 이 클래스를 구현하여 사용자 지정 ConfigurationElement 요소의 컬렉션을 ConfigurationSection에 추가할 수 있습니다. |
|
구성 파일 내의 요소를 나타냅니다. ConfigurationSection과 같은 XML 구성 요소를 나타내는 클래스의 기본 클래스로 ConfigurationElement를 사용합니다. ConfigurationElement 클래스를 확장하여 ConfigurationSection 내의 구성 요소를 나타낼 수 있으며, ConfigurationElement 요소의 ConfigurationElementCollection을 만들 수도 있습니다. 모든 ConfigurationElement 개체는 요소 특성이나 자식 요소의 컬렉션을 나타내는 ConfigurationProperty 개체의 내부 ConfigurationPropertyCollection 컬렉션을 만듭니다. |
|
구성 요소 속성 컬렉션을 인스턴스화하도록 .NET Framework에 선언적으로 지시합니다. ConfigurationCollectionAttribute를 사용하여 ConfigurationElementCollection 속성에 특성을 추가할 수 있습니다. 이 방법을 통해 사용자 지정 ConfigurationElement 값을 사용하여 속성을 인스턴스화하고 초기화하도록 .NET Framework에 지시합니다. |
|
ConfigurationPropertyCollection 클래스는 특성 또는 구성 요소의 ConfigurationElement 개체일 수 있는 ConfigurationProperty 개체의 컬렉션을 나타냅니다. |
|
특성 또는 구성 요소의 자식을 나타냅니다. 단순한 ConfigurationElement의 경우 ConfigurationProperty 개체는 특성을 나타냅니다. 하위 섹션이 포함된 섹션과 같은 더 복잡한 구성 요소의 경우에는 ConfigurationProperty 개체가 ConfigurationElement 개체와 특성을 나타낼 수 있습니다. ConfigurationProperty 클래스는 개별 구성 설정을 나타냅니다. 이 클래스를 사용하면 특정 구성 엔터티(특성 또는 요소)의 이름, 형식 및 기본값을 가져오거나 설정하고, 특성이 필수 특성인지, 컬렉션 키인지 또는 기본 요소 컬렉션을 나타내는지를 지정할 수 있습니다. |
|
구성 요소 속성을 인스턴스화하도록 .NET Framework에 선언적으로 지시합니다. ConfigurationPropertyAttribute를 사용하여 구성 요소 속성을 데코레이팅할 수 있습니다. 이 방법을 통해 데코레이팅 매개 변수 값을 사용하여 속성을 인스턴스화하고 초기화하도록 .NET Framework에 지시합니다. |
참고 항목
작업
방법: ConfigurationSection을 사용하여 사용자 지정 구성 섹션 만들기
방법: IConfigurationSectionHandler를 사용하여 사용자 지정 구성 섹션 만들기