Элемент connectionStrings (схема параметров ASP.NET)

  • Статья

Обновлен: Ноябрь 2007

Задает для приложений и функций ASP.NET коллекцию строк подключения к базам данных в виде пар "имя-значение".

Этот элемент не использовался до .NET Framework версии 2.0.

Элемент configuration (схема общих параметров)
  Элемент connectionStrings (схема параметров ASP.NET)

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

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние элементы и родительские элементы для данного элемента.

Атрибуты

Нет, за исключением атрибутов, унаследованных всеми элементами раздела. Дополнительные сведения см. в разделе Общие атрибуты, наследуемые элементами раздела.

Дочерние элементы

Элемент

Описание

Add

Добавляет в коллекцию строк подключения строку подключения в виде пары имя-значение.

Clear

Удаляет все ссылки на унаследованные строки подключения, разрешая только строки подключения, добавленные текущим элементом add.

remove

Удаляет ссылку на унаследованную строку подключения из коллекции строк подключения.

Родительские элементы

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .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

См. также

Задачи

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о конфигурационном ASP.NET

Настройка обеспечения безопасности ASP.NET

Общие сведения о доступе к данным в ASP.NET

Создание базы данных служб приложения для сервера SQL Server

Безопасность доступа к данным

Ссылки

Элемент configuration (схема общих параметров)

Элемент add для элемента connectionStrings (схема параметров ASP.NET)

Элемент clear для элемента connectionStrings (схема параметров ASP.NET)

Элемент remove для элемента connectionStrings (схема параметров ASP.NET)

Другие ресурсы

Параметры конфигурации ASP.NET