connectionStrings 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

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

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

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

특성 및 요소

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

특성

모든 section 요소에서 상속되는 특성 외에 다른 특성은 없습니다. 자세한 내용은 section 요소에서 상속된 일반 특성을 참조하십시오. ASP.NET 응용 프로그램의 런타임에 ConfigSource 특성에 대체 구성 파일의 이름을 지정할 수 있습니다. 이 경우 Web.config 파일에 포함된 기본 연결 문자열 정보로 파일의 내용을 덮어씁니다. 또한 대체 파일이 존재하지 않고 런타임에 만들어질 때 발생합니다. Web.config에 연결 문자열 정보가 포함되어 있지 않은 경우 빈 connectionStrings 섹션이 대체 파일에 추가됩니다.

자식 요소

요소	설명
Add	연결 문자열 컬렉션에 연결 문자열을 이름/값 쌍으로 추가합니다.
Clear	현재 add 요소에 추가된 연결 문자열만 허용하고 상속된 연결 문자열에 대한 모든 참조를 제거합니다.
remove	연결 문자열의 컬렉션에서 상속된 연결 문자열에 대한 참조를 제거합니다.

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
System.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.

설명

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

이전 버전의 ASP.NET에서는 연결 문자열이 appSettings에 저장되었습니다. ASP.NET 2.0에서 세션, 멤버 자격, 개인 설정 및 역할 관리자와 같은 기능은 connectionStrings 요소에 저장된 연결 문자열을 사용합니다. connectionStrings 요소를 사용하여 응용 프로그램에 대한 연결 문자열을 저장할 수도 있습니다.

기본 구성

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

connectionStrings 요소에 프로그래밍 방식으로 액세스할 수 있습니다. 자세한 내용은 ConnectionStrings 예제를 참조하십시오.

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

예제

다음 코드 예제에서는 두 개의 연결 문자열을 구성하는 방법을 보여 줍니다. 첫 번째 연결 문자열은 ASP.NET 응용 프로그램에 사용될 수 있고 두 번째 연결 문자열은 나중에 구성되는 sqlCacheDependency 요소에 사용됩니다.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

요소 정보

구성 섹션 처리기	ConnectionStringsSection
구성 멤버	ConnectionStringSettingsCollection ConnectionStrings ConnectionStrings ConnectionStrings
구성 가능한 위치	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

참고 항목

Share via