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

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

Добавляет ссылку на сборку в коллекцию.

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    Элемент compilation (схема параметров ASP.NET)
      Элемент assemblies для элемента compilation (схема параметров ASP.NET)
        Элемент add для элемента assemblies для элемента compilation (схема параметров ASP.NET)

<add 
   assembly="Assembly 
             [,Version=version number] 
             [,Culture=culture] 
             [,PublicKeyToken=token]"
/>

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

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

Атрибуты

Атрибут

Описание

assembly

Обязательный атрибут String.

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

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

Отсутствуют.

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

Элемент

Описание

configuration

Корневой элемент в любом файле конфигурации, который используется средой CLR и приложениями платформы .NET Framework.

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

compilation

Настраивает все параметры, используемые ASP.NET для компиляции приложений.

assemblies

Определяет коллекцию имен сборок, используемых во время компиляции приложения ASP.NET.

Заметки

Элемент add добавляет ссылку на сборку, которая будет использоваться в процессе компиляции динамического ресурса. При компиляции каждого модуля кода ASP.NET автоматически связывает эту сборку c ресурсом.

Значение элемента add представляет собой имя сборки, а не путь к библиотеке DLL. В ASP.NET для нахождения физического местоположения библиотеки DLL производится поиск имени сборки. Можно дополнительно указать подстановочный знак "*" (звездочка) для добавления каждой сборки из кэша закрытых сборок приложения, расположенного в подкаталоге \bin приложения или в каталоге установки платформы .NET Framework (%systemroot%\Microsoft.NET\Framework\version\). Подробные сведения см. в разделе Load.

Настройки по умолчанию

В корневом файле Web.config задан по умолчанию следующий элемент assemblies.

<assemblies>
    <add assembly="mscorlib" />
    <add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.EnterpriseServices, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="*" />
</assemblies>

Пример

В следующем примере кода демонстрируется добавление в приложение ссылки на сборку.

<configuration>
   <system.web>
      <compilation>
         <assemblies>
            <add assembly="System.Data, Version=1.0.2411.0, 
                           Culture=neutral, 
                           PublicKeyToken=b77a5c561934e089"/>
         </assemblies>
      </compilation>
   </system.web>
</configuration>

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

Обработчик раздела конфигурации

CompilationSection

Элемент конфигурации

Add

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

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

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

Общие сведения о компиляции в ASP.NET

Общие сведения о синтаксисе веб-страниц ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

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

Сценарии конфигурации ASP.NET

Ссылки

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

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

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

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

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

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

CompilationSection

System.Configuration

System.Web.Configuration

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

Общие параметры конфигурации (ASP.NET)

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

Администрирование веб-узлов ASP.NET

Файлы конфигурации ASP.NET

Конфигурационный интерфейс API ASP.NET