appSettings 요소(일반 설정 스키마)
[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]
파일 경로, XML Web services URL 또는 응용 프로그램의 .ini 파일에 저장된 정보와 같은 사용자 지정 응용 프로그램 설정을 포함합니다.
<appSettings
file="relative file name" >
</appSettings>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
요소 |
설명 |
|---|---|
file |
선택적 String 특성입니다. 사용자 지정 응용 프로그램 구성 설정이 포함된 외부 파일의 상대 경로를 지정합니다. 지정된 파일은 appSettings add, clear 및 remove 특성에 지정된 설정과 같은 종류의 설정을 포함하고 이러한 요소와 동일한 키/값 쌍 형식을 사용합니다. 지정된 경로는 로컬 구성 파일에 대해 상대적입니다. 지정된 파일을 찾을 수 없으면 런타임에서 이 특성을 무시합니다. Web.config 파일을 변경하면 응용 프로그램이 다시 시작되므로 별도의 파일을 통해 응용 프로그램을 다시 시작하지 않고도 사용자가 appSettings 섹션의 값을 수정할 수 있습니다. 이 파일의 내용은 Web.config 파일의 appSettings 섹션에 병합됩니다. 이 기능은 appSettings 특성으로 제한됩니다. 참고 이제 .NET Framework 버전 2.0에서는 configSource 특성을 지원하는 모든 구성 요소에 대한 구성 설정을 별도의 파일에 포함할 수 있습니다. 그러나 configSource 특성을 사용하는 경우에는 요소 설정을 병합하는 기능이 없으므로 전체 섹션을 별도의 파일로 이동해야 합니다. configSource 특성을 사용하는 경우 Web.config 파일에는 한 번 기록됩니다. 이때 응용 프로그램이 다시 시작되지만 이후에 섹션을 업데이트하면 별도의 파일에 내용이 직접 기록되므로 응용 프로그램이 다시 시작되는 문제가 발생하지 않습니다. 자세한 내용은 ConfigSource를 참조하십시오. |
상속된 특성 |
선택적 특성입니다. 모든 section 요소가 상속하는 특성입니다. |
자식 요소
요소 |
설명 |
|---|---|
add |
선택적 요소입니다. 사용자 지정 응용 프로그램 설정을 응용 프로그램 설정 컬렉션에 이름/값 쌍으로 추가합니다. |
clear |
선택적 요소입니다. 현재 add 특성에 추가된 참조만 허용하고 상속된 사용자 지정 응용 프로그램 설정에 대한 모든 참조를 제거합니다. |
remove |
선택적 요소입니다. 상속된 사용자 지정 응용 프로그램 설정에 대한 참조를 응용 프로그램 설정 컬렉션에서 제거합니다. |
부모 요소
요소 |
설명 |
|---|---|
configuration |
공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다. |
system.web |
구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다. |
설명
appSettings 요소는 파일 경로, XML Web services URL 또는 응용 프로그램의 .ini 파일에 저장된 정보와 같은 사용자 지정 응용 프로그램 구성 정보를 저장합니다. appSettings 요소에 지정된 키/값 쌍은 ConfigurationManager 클래스를 사용하여 코드에서 액세스할 수 있습니다. appSettings에 프로그래밍 방식으로 액세스하는 방법은 클래스에 나와 있는 코드 예제를 참조하십시오.
file 특성을 사용하면 추가 설정을 제공하거나 appSettings 요소에 지정된 설정을 재정의하는 구성 파일을 지정할 수 있습니다. 사용자가 응용 프로그램 구성 파일에 지정된 프로젝트 설정을 재정의하려는 경우처럼 소스 제어 팀 개발 시나리오에서 file 특성을 사용할 수 있습니다. file 특성에 지정된 구성 파일의 루트 노드는 configuration 요소가 아니라 appSettings 요소여야 합니다.
.NET Framework 버전 2.0 응용 프로그램에서는 응용 프로그램 설정 컬렉션 대신 connectionStrings 요소(ASP.NET 설정 스키마) 컬렉션에 데이터베이스 연결 문자열을 저장합니다.
기본 구성
다음의 기본 appSettings 요소는 Machine.config 파일 또는 루트 Web.config 파일에 명시적으로 구성되어 있지 않습니다. 그러나 이 요소는 응용 프로그램에서 반환하는 기본 구성입니다.
<appSettings file="">
<settings>
<clear />
</settings>
</appSettings>
예제
file 특성에 지정된 구성 파일의 루트 노드는 configuration 요소가 아니라 appSettings 요소여야 합니다.
다음 코드 예제에서는 file 특성에 지정된 구성 파일에 대해 올바른 형식을 사용하는 방법을 보여 줍니다.
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
다음 코드 예제에서는 구성 파일에 사용자 지정 응용 프로그램 설정을 정의하는 방법을 보여 줍니다.
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</configuration>
요소 정보
구성 섹션 처리기 |
|
구성 멤버 |
|
구성 가능한 위치 |
Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config |
요구 사항 |
Microsoft IIS(인터넷 정보 서비스) 5.0, 5.1 또는 6.0 .NET Framework 버전 1.0, 1.1 또는 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005 |
참고 항목
참조
appSettings에 대한 add 요소(일반 설정 스키마)
appSettings에 대한 clear 요소(일반 설정 스키마)
appSettings에 대한 remove 요소(일반 설정 스키마)