사용자 지정 섹션 처리기를 만드는 데 사용되는 클래스

Visual Studio 2010

업데이트: 2007년 11월

기존 구성 섹션 중 요구에 맞는 섹션이 없으면 사용자 지정 섹션을 만들고 구성 데이터를 읽고 쓰도록 처리기를 구현할 수 있습니다. 처리기는 ConfigurationSection 클래스를 확장하는 .NET Framework 클래스여야 합니다.

ms228062.alert_note(ko-kr,VS.100).gif참고:

.NET Framework 버전 1.0 및 1.1에서는 구성 섹션 처리기가 IConfigurationSectionHandler 인터페이스를 구현해야 하며, 이 인터페이스는 .NET Framework 버전 2.0에서도 지원되었으나 이제는 사용되지 않습니다.

사용자 지정 섹션 처리기는 두 가지 구현 모델인 프로그래밍 모델과 선언적 모델 중 하나를 사용하여 구현할 수 있습니다.

이 모델을 사용하려면 각 섹션 특성마다 속성을 만들어 값을 가져오거나 설정하고 내부 ConfigurationElement 기본 클래스의 내부 속성 컬렉션에 추가해야 합니다.

특성 모델이라고도 하는 이 모델을 사용하면 속성 및 설정 특성을 통해 섹션 특성을 정의할 수 있습니다. 이 특성은 ASP.NET 구성 시스템에 속성 형식과 기본값에 대한 정보를 알려 줍니다. ASP.NET 구성 시스템에서는 리플렉션을 통해 가져오는 이 정보를 사용하여 섹션 속성 개체를 만들고 필요한 초기화를 수행합니다. 리플렉션에 대한 자세한 내용은 리플렉션 개요를 참조하십시오.

다음 표에서는 프로그래밍 방식으로 사용자 지정 섹션 처리기를 만드는 데 사용되는 클래스를 보여 줍니다.

각 클래스 항목에는 구현 모델 중 하나 또는 모두를 사용하는 자세한 코드 예제가 있습니다. 또한 방법: ConfigurationSection을 사용하여 사용자 지정 구성 섹션 만들기에서 단순화된 선언적 코드 예제를 볼 수 있습니다.

섹션 처리기 구현에 사용되는 클래스

설명

ConfigurationSection 클래스

구성 파일 내의 섹션을 나타냅니다.

ConfigurationSection을 사용하여 사용자 지정 섹션 처리기 형식을 구현할 수 있으며, ConfigurationSection 클래스를 확장하여 사용자 지정 처리 및 사용자 지정 구성 섹션에 대한 프로그래밍 액세스를 제공할 수 있습니다.

섹션에서는 구성 파일의 configSections 요소에 있는 항목을 사용하여 처리 형식을 등록합니다.

ConfigurationSectionCollection 클래스

구성 파일 내에서 관련 섹션의 컬렉션을 나타냅니다.

ConfigurationSection 클래스를 확장하는 사용자 지정 형식을 만들 때 ConfigurationSectionCollection을 사용합니다. 또한 ConfigurationSection 개체의 컬렉션을 통해 프로그래밍 방식으로 구성 파일을 읽을 때 사용합니다.

ConfigurationElementCollection 클래스

구성 파일 내 요소의 컬렉션을 나타냅니다.

ConfigurationElement 개체의 컬렉션에 대한 작업을 할 때 ConfigurationElementCollection을 사용합니다. 이 클래스를 구현하여 사용자 지정 ConfigurationElement 요소의 컬렉션을 ConfigurationSection에 추가할 수 있습니다.

ConfigurationElement 클래스

구성 파일 내의 요소를 나타냅니다.

ConfigurationSection과 같은 XML 구성 요소를 나타내는 클래스의 기본 클래스로 ConfigurationElement를 사용합니다.

ConfigurationElement 클래스를 확장하여 ConfigurationSection 내의 구성 요소를 나타낼 수 있으며, ConfigurationElement 요소의 ConfigurationElementCollection을 만들 수도 있습니다. 모든 ConfigurationElement 개체는 요소 특성이나 자식 요소의 컬렉션을 나타내는 ConfigurationProperty 개체의 내부 ConfigurationPropertyCollection 컬렉션을 만듭니다.

ConfigurationCollectionAttribute 클래스

구성 요소 속성 컬렉션을 인스턴스화하도록 .NET Framework에 선언적으로 지시합니다.

ConfigurationCollectionAttribute를 사용하여 ConfigurationElementCollection 속성에 특성을 추가할 수 있습니다. 이 방법을 통해 사용자 지정 ConfigurationElement 값을 사용하여 속성을 인스턴스화하고 초기화하도록 .NET Framework에 지시합니다.

ConfigurationPropertyCollection 클래스

ConfigurationPropertyCollection 클래스는 특성 또는 구성 요소의 ConfigurationElement 개체일 수 있는 ConfigurationProperty 개체의 컬렉션을 나타냅니다.

ConfigurationProperty 클래스

특성 또는 구성 요소의 자식을 나타냅니다. 단순한 ConfigurationElement의 경우 ConfigurationProperty 개체는 특성을 나타냅니다. 하위 섹션이 포함된 섹션과 같은 더 복잡한 구성 요소의 경우에는 ConfigurationProperty 개체가 ConfigurationElement 개체와 특성을 나타낼 수 있습니다.

ConfigurationProperty 클래스는 개별 구성 설정을 나타냅니다. 이 클래스를 사용하면 특정 구성 엔터티(특성 또는 요소)의 이름, 형식 및 기본값을 가져오거나 설정하고, 특성이 필수 특성인지, 컬렉션 키인지 또는 기본 요소 컬렉션을 나타내는지를 지정할 수 있습니다.

ConfigurationPropertyAttribute 클래스

구성 요소 속성을 인스턴스화하도록 .NET Framework에 선언적으로 지시합니다.

ConfigurationPropertyAttribute를 사용하여 구성 요소 속성을 데코레이팅할 수 있습니다. 이 방법을 통해 데코레이팅 매개 변수 값을 사용하여 속성을 인스턴스화하고 초기화하도록 .NET Framework에 지시합니다.

표시: