add, élément de assemblies pour compilation (Schéma des paramètres ASP.NET)

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute une référence d'assembly à la collection.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    compilation, élément (Schéma des paramètres ASP.NET)
      assemblies, élément de compilation (Schéma des paramètres ASP.NET)
        add, élément de assemblies pour compilation (Schéma des paramètres ASP.NET)

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
assembly	Attribut String requis. Spécifie une combinaison class/assembly séparée par des virgules et constituée de jetons de version, de culture et de clé publique. ASP.NET commence par rechercher la DLL d'assembly dans le répertoire Bin privé de l'application, puis dans le cache système des assemblys.

assembly

Attribut String requis.

Spécifie une combinaison class/assembly séparée par des virgules et constituée de jetons de version, de culture et de clé publique. ASP.NET commence par rechercher la DLL d'assembly dans le répertoire Bin privé de l'application, puis dans le cache système des assemblys.

Éléments enfants

Aucun

Éléments parents

Élément	Description
configuration	Élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine de la section de configuration ASP.NET.
compilation	Configure tous les paramètres de compilation qu'ASP.NET utilise pour compiler des applications.
assemblies	Définit une collection de noms d'assemblys qui sont utilisés pendant la compilation d'une application ASP.NET.

Notes

L'élément add ajoute la référence d'un assembly à utiliser pendant la compilation d'une ressource dynamique. ASP.NET lie automatiquement cet assembly à la ressource lors de la compilation de chaque module de code.

La valeur de l'élément add est un nom d'assembly et pas un chemin d'accès de DLL. ASP.NET recherche le nom de l'assembly pour trouver l'emplacement physique de sa DLL. Vous pouvez, le cas échéant, spécifier le caractère générique * (astérisque) pour ajouter chaque assembly dans le cache d'assembly privé de l'application, qui se situe soit dans le sous-répertoire \bin d'une application, soit dans le répertoire d'installation du .NET Framework (%systemroot%\Microsoft.NET\Framework\version\). Pour plus d'informations, consultez Load.

Configuration par défaut

L'élément assemblies par défaut suivant est configuré dans le fichier Web.config racine.

<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>

Exemple

L'exemple de code suivant montre comment ajouter une référence d'assembly à une application.

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

Informations sur les éléments

Gestionnaire de section de configuration	CompilationSection
Membre de configuration	Add
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Partager via

add, élément de assemblies pour compilation (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires