Share via


appSettings에 대한 add 요소(일반 설정 스키마)

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

응용 프로그램 설정 컬렉션에 사용자 지정 응용 프로그램 설정을 이름/값 쌍으로 추가합니다.

<add
   key="String name"
   value="String value"
/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성

설명

key

필수 String 특성입니다.

응용 프로그램 설정의 이름을 지정합니다. 이 특성은 컬렉션 키입니다.

value

필수 String 특성입니다.

응용 프로그램 설정의 값을 지정합니다.

상속된 특성

선택적 특성입니다.

모든 section 요소가 상속하는 특성입니다. 자세한 내용은 section 요소에서 상속된 일반 특성을 참조하십시오.

자식 요소

없음

부모 요소

요소

설명

configuration

공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.

system.web

구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.

appSettings

파일 경로, XML Web services URL 또는 응용 프로그램의 .ini 파일에 저장된 정보와 같은 사용자 지정 응용 프로그램 설정을 포함합니다.

설명

add 요소는 appSettings 요소에 있는 상속된 응용 프로그램 설정 컬렉션에 사용자 지정 응용 프로그램 설정을 이름/값 쌍으로 추가합니다.

중요

키는 고유해야 합니다.같은 키를 가진 여러 항목을 추가하는 경우 마지막 항목만 유지됩니다.

appSettings 요소는 파일 경로, XML Web services URL 또는 응용 프로그램의 .ini 파일에 저장된 정보와 같은 사용자 지정 응용 프로그램 구성 정보를 저장합니다. appSettings 요소에 지정된 키/값 쌍은 ConfigurationSettings 클래스를 사용하여 코드에서 액세스할 수 있습니다. 클래스 예제에서는 appSettings에 프로그래밍 방식으로 액세스하는 방법을 보여 줍니다.

기본 구성

다음의 기본 appSettings 요소는 .NET Framework 버전 1.0 및 1.1의 Machine.config 파일에 구성되어 있습니다.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </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>

요소 정보

구성 섹션 처리기

AppSettingsSection

구성 멤버

Add

구성 가능한 위치

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 요소(일반 설정 스키마)

configuration 요소(일반 설정 스키마)

appSettings에 대한 clear 요소(일반 설정 스키마)

appSettings에 대한 remove 요소(일반 설정 스키마)

개념

Securing Configuration

Configuration Inheritance

기타 리소스

일반 구성 설정(ASP.NET)

ASP.NET 구성 설정

ASP.NET Configuration Files