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

Статья
08/11/2011

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

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

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

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

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

Атрибуты

Нет, за исключением атрибутов, унаследованных всеми элементами раздела. Дополнительные сведения см. в разделе Общие атрибуты, наследуемые элементами раздела. В приложениях ASP.NET во время выполнения можно назначить атрибуту ConfigSource имя файла альтернативной конфигурации. В этом случае содержимое файла перезаписывается сведениями строки подключения по умолчанию, которая содержится в файле Web.config. Это также происходит, если альтернативный файл не существует и создается во время выполнения. Если файл Web.config не содержит никаких сведений строки подключения, в альтернативный файл добавляется пустой раздел 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

См. также

Поделиться через

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

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

Атрибуты

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

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

Заметки

Параметры по умолчанию

Пример

Сведения об элементе

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы