<Elemento qualifyAssembly>

  • Articolo

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

<Configurazione>
  <Runtime>
    <assemblyBinding>
      <qualifyAssembly>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
partialName Attributo obbligatorio.

Specifica il nome parziale dell'assembly come viene visualizzato nel codice.
fullName Attributo obbligatorio.

Specifica il nome completo dell'assembly come viene 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 Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
runtime Contiene informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.

Commenti

La chiamata al Assembly.Load metodo usando nomi di assembly parziali causa la ricerca dell'assembly solo nella directory di base dell'applicazione. Usare l'elemento <qualifyAssembly> nel file di configurazione dell'applicazione per fornire le informazioni sull'assembly completo (nome, versione, token di chiave pubblica e impostazioni cultura) e causare la ricerca dell'assembly nella global assembly cache.

L'attributo fullName deve includere i quattro campi dell'identità dell'assembly: nome, versione, token di chiave pubblica e impostazioni cultura. L'attributo partialName deve fare parzialmente riferimento a un assembly. È necessario specificare almeno il nome di testo dell'assembly (il caso più comune), ma è anche possibile includere la versione, il token di chiave pubblica o le impostazioni cultura (o qualsiasi combinazione dei quattro, ma non tutti e quattro). Il nome parziale deve corrispondere al nome specificato nella chiamata. Ad esempio, non è possibile specificare "math" come attributo partialName nel file di configurazione e chiamare Assembly.Load("math, Version=3.3.3.3") nel codice.

Esempio

L'esempio seguente trasforma logicamente la chiamata Assembly.Load("math") 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>

Vedi anche