connectionStrings에 대한 add 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

연결 문자열 컬렉션에 연결 문자열을 이름/값 쌍으로 추가합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<add 
   name="connection string name"
   connectionString="connection string"
   providerName="ADO.NET data provider" 
/>

특성 및 요소

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

특성

특성	설명
connectionString	필수 String 특성입니다. 연결 문자열 값을 정의합니다. 이 값은 빈 문자열("")일 수 있습니다. 값이 유효한지 확인하는 검사는 수행되지 않습니다. 기본값은 빈 문자열("")입니다.
name	필수 String 특성입니다. 연결 문자열 값에 액세스할 때 사용할 키를 정의합니다. 이 특성은 이름이 같은 모든 상속된 키를 재정의합니다. 기본값은 빈 문자열("")입니다.
providerName	선택적 String 특성입니다. 내부 데이터 저장소에 액세스할 때 사용할 ADO.NET 공급자의 이름입니다. 기본값은 "System.Data.SqlClient"입니다.
상속된 특성	선택적 특성입니다. 모든 section 요소가 상속하는 특성입니다. 자세한 내용은 section 요소에서 상속된 일반 특성를 참조하십시오.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.
connectionStrings	ASP.NET 응용 프로그램 및 ASP.NET 기능에 대한 데이터베이스 연결 문자열의 컬렉션을 이름/값 쌍으로 지정합니다.

설명

add 요소는 connectionStrings 요소에 있는 연결 문자열 컬렉션에 연결 문자열을 이름/값 쌍으로 추가합니다.

connectionStrings 요소는 ASP.NET 응용 프로그램 및 ASP.NET 기능에 대한 데이터베이스 연결 문자열의 컬렉션을 이름/값 쌍으로 지정합니다.

기본 구성

자식 구성 파일에서 clear 요소가 사용되지 않으면 부모 구성 파일에 포함된 연결 문자열이 상속됩니다. 다음의 기본 element 요소는 Machine.config 파일에 구성되어 있습니다.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

예제

다음 코드 예제에서는 Northwind 데이터베이스를 사용하는 응용 프로그램에 대한 연결 문자열을 구성하는 방법을 보여 줍니다.

<configuration>
  <connectionStrings>
    <add name="Northwind"
         connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;" 
         providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

요소 정보

구성 섹션 처리기	ConnectionStringsSection
구성 멤버	Add(ConnectionStringSettings)
구성 가능한 위치	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

참고 항목

다음을 통해 공유