<Elemento qualifyAssembly>

Articolo
04/08/2023

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>

Condividi tramite