Elemento add per assemblies per compilation (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Consente di aggiungere all'insieme un riferimento all'assembly.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento compilation (schema delle impostazioni ASP.NET)
      Elemento assemblies per compilation (schema delle impostazioni ASP.NET)
        Elemento add per assemblies per compilation (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo

Descrizione

assembly

Attributo String obbligatorio.

Specifica una combinazione di assembly separati da virgole costituita da token di versione, impostazioni cultura e chiave pubblica. In ASP.NET la DLL dell'assembly viene cercata innanzitutto nella directory privata Bin dell'applicazione e quindi nella cache dell'assembly del sistema.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

Elemento di primo livello presente in ogni file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

compilation

Configura tutte le impostazioni di compilazione utilizzate in ASP.NET per compilare le applicazioni.

assemblies

Consente di definire un insieme di nomi di assembly utilizzati durante la compilazione di un'applicazione ASP.NET.

Note

L'elemento add consente di aggiungere un riferimento a un assembly, da utilizzare durante la compilazione di una risorsa dinamica. In ASP.NET questo assembly viene collegato automaticamente alla risorsa, durante la compilazione di ciascun modulo di codice.

Il valore dell'elemento add corrisponde al nome di un assembly e non al percorso di una DLL. In ASP.NET viene ricercato il nome dell'assembly per individuare l'ubicazione della DLL. È possibile specificare eventualmente il carattere jolly asterisco (*) per aggiungere tutti gli assembly all'interno della cache dell'assembly privato di un'applicazione, che si trova nella sottodirectory \bin dell'applicazione o nella directory di installazione di .NET Framework (%systemroot%\Microsoft.NET\Framework\versione\). Per informazioni dettagliate, vedere Load.

Configurazione predefinita

Il seguente elemento assemblies predefinito viene configurato nel file Web.config a livello di radice.

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere un riferimento a un assembly in un'applicazione.

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

Informazioni sull'elemento

Gestore della sezione di configurazione

CompilationSection

Membro di configurazione

Add

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config a livello di directory fisica o virtuale

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 1.0, 1.1 o 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulla compilazione in ASP.NET

Cenni preliminari sulla sintassi delle pagine Web ASP.NET

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento assemblies per compilation (schema delle impostazioni ASP.NET)

Elemento clear per assemblies per compilation (schema delle impostazioni ASP.NET)

Elemento remove per assemblies per compilation (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento compilation (schema delle impostazioni ASP.NET)

CompilationSection

System.Configuration

System.Web.Configuration

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

File di configurazione ASP.NET

API di configurazione di ASP.NET