Elemento <qualifyAssembly>

Aggiornamento: novembre 2007

Specifica il nome completo dell'assembly da caricare in modo dinamico quando viene utilizzato un nome parziale.

Elemento <Configuration>
  Elemento <runtime>
    Elemento <assemblyBinding> per <runtime>
      Elemento <qualifyAssembly>

<qualifyAssembly partialName="PartialAssemblyName"
                                  fullName="FullAssemblyName"/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo

Descrizione

partialName

Attributo obbligatorio.

Specifica il nome parziale dell'assembly, così come è visualizzato nel codice.

fullName

Attributo obbligatorio.

Specifica il nome parziale dell'assembly, così come è visualizzato nella Global Assembly Cache.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

assemblyBinding

Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.

configuration

È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

runtime

Contiene le informazioni sull'associazione degli assembly e la procedura di Garbage Collection.

Note

Se si chiama il metodo Assembly.Load mediante nomi di assembly parziali, in Common Language Runtime la ricerca dell'assembly viene eseguita solo nella directory di base dell'applicazione. Utilizzare l'elemento <qualifyAssembly> nel file di configurazione dell'applicazione per tutte le informazioni sull'assembly, ovvero nome, versione, token di chiave pubblica e impostazioni cultura, e fare in modo che in Common Language Runtime la ricerca dell'assembly venga eseguita nella Global Assembly Cache.

È necessario che l'attributo fullName comprenda i quattro campi relativi all'identità dell'assembly, ovvero nome, versione, token di chiave pubblica e impostazioni cultura, e che l'attributo partialName includa un riferimento parziale a un assembly. È necessario specificare almeno il nome in formato testo dell'assembly (condizione più comune), ma è possibile includere anche la versione, il token di chiave pubblica o le impostazioni cultura oppure una qualsiasi combinazione di tali elementi. È tuttavia necessario non includere tutti e quattro gli elementi. È necessario che l'elemento partialName corrisponda al nome specificato nella chiamata. Non è possibile, ad esempio, specificare "math" come attributo partialName nel file di configurazione e chiamare Assembly.Load("math, Version=3.3.3.3") all'interno del codice.

Esempio

Nell'esempio seguente la chiamata Assembly.Load("math") viene modificata in Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral").

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <qualifyAssembly partialName="math" 
                         fullName=
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>
      </assemblyBinding>
   </runtime>
</configuration>

Vedere anche

Concetti

Come il runtime individua gli assembly

Riferimenti di assembly parziali

Riferimenti

Schema delle impostazioni dell'ambiente di esecuzione