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

Статья
08/11/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".
Наследуемые атрибуты	Необязательные атрибуты. Атрибуты, наследуемые всеми элементами раздела. Дополнительные сведения см. в разделе Общие атрибуты, наследуемые элементами раздела.

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

Отсутствует.

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

Элемент	Описание
configuration	Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.
system.web	Определяет корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.
connectionStrings	Задает для приложений и функций ASP.NET коллекцию строк подключения к базам данных в виде пар "имя-значение".

Заметки

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

Элемент connectionStrings задает для приложений и функций 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

См. также

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