<qualifyAssembly> elemento<qualifyAssembly> Element

Specifica il nome completo dell'assembly da caricare in modo dinamico quando viene usato un nome parziale.Specifies the full name of the assembly that should be dynamically loaded when a partial name is used.

<configuration><configuration>
<runtime><runtime>
<assemblyBinding ><assemblyBinding>
<qualifyAssembly ><qualifyAssembly>

SintassiSyntax

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

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
partialName Attributo obbligatorio.Required attribute.

Specifica il nome parziale dell'assembly come appare nel codice.Specifies the partial name of the assembly as it appears in the code.
fullName Attributo obbligatorio.Required attribute.

Specifica il nome completo dell'assembly come appare nella global assembly cache.Specifies the full name of the assembly as it appears in the global assembly cache.

Elementi figlioChild Elements

Nessuno.None.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
assemblyBinding Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.Contains information about assembly version redirection and the locations of assemblies.
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contiene informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.Contains information about assembly binding and garbage collection.

NoteRemarks

La chiamata di Assembly.Load metodo utilizzando nomi di assembly parziali fa sì che common language runtime cercare l'assembly solo nella directory base dell'applicazione.Calling the Assembly.Load method using partial assembly names causes the common language runtime to look for the assembly only in the application base directory. Utilizzare il <qualifyAssembly > elemento nel file di configurazione dell'applicazione per informazioni sull'assembly (nome, versione, token di chiave pubblica e impostazioni cultura) e causare common language runtime per la ricerca per l'assembly nella global assembly cache.Use the <qualifyAssembly> element in your application configuration file to provide the full assembly information (name, version, public key token, and culture) and cause the common language runtime to search for the assembly in the global assembly cache.

Il fullName attributo deve includere i quattro campi relativi all'identità dell'assembly: nome, versione, token di chiave pubblica e impostazioni cultura.The fullName attribute must include the four fields of assembly identity: name, version, public key token, and culture. Il partialName attributo parzialmente deve fare riferimento a un assembly.The partialName attribute must partially reference an assembly. È necessario specificare almeno il nome dell'assembly testo (il caso più comune), ma è anche possibile includere una versione, token di chiave pubblica o delle impostazioni cultura (o qualsiasi combinazione di quattro, ma non tutti e quattro).You must specify at least the assembly's text name (the most common case), but you can also include version, public key token, or culture (or any combination of the four, but not all four). Il partialName deve corrispondere al nome specificato nella chiamata.The partialName must match the name specified in your call. Ad esempio, è possibile specificare "math" come il partialName attributo nel file di configurazione e chiamare Assembly.Load("math, Version=3.3.3.3") nel codice.For example, you cannot specify "math" as the partialName attribute in your configuration file and call Assembly.Load("math, Version=3.3.3.3") in your code.

EsempioExample

Nell'esempio seguente viene logicamente la chiamata Assembly.Load("math") in Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral").The following example logically turns the call Assembly.Load("math") into 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 ancheSee Also

Schema delle impostazioni di runtimeRuntime Settings Schema
Come il runtime individua gli assemblyHow the Runtime Locates Assemblies
NIB: I riferimenti ad Assembly parzialiNIB: Partial Assembly References