<het element qualifyAssembly>

Artikel
05/10/2023

Hiermee geeft u de volledige naam van de assembly die dynamisch moet worden geladen wanneer een gedeeltelijke naam wordt gebruikt.

<configuratie>
  <Runtime>
    <assemblyBinding>
      <qualifyAssembly>

Syntax

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
`partialName`	Vereist kenmerk. Hiermee geeft u de gedeeltelijke naam van de assembly zoals deze wordt weergegeven in de code.
`fullName`	Vereist kenmerk. Hiermee geeft u de volledige naam van de assembly zoals deze wordt weergegeven in de globale assembly-cache.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element	Beschrijving
`assemblyBinding`	Bevat informatie over omleiding van assemblyversies en de locaties van assembly's.
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`runtime`	Bevat informatie over assemblagebinding en garbagecollection.

Opmerkingen

Het aanroepen van de Assembly.Load methode met behulp van gedeeltelijke assemblynamen zorgt ervoor dat de algemene taalruntime alleen naar de assembly zoekt in de basismap van de toepassing. Gebruik het <element qualifyAssembly> in het configuratiebestand van uw toepassing om de volledige assembly-informatie op te geven (naam, versie, token voor openbare sleutels en cultuur) en ervoor te zorgen dat de runtime in de algemene taal naar de assembly zoekt in de globale assemblycache.

Het kenmerk fullName moet de vier velden van assembly-identiteit bevatten: naam, versie, token voor openbare sleutels en cultuur. Het kenmerk partialName moet gedeeltelijk verwijzen naar een assembly. U moet ten minste de tekstnaam van de assembly opgeven (het meest voorkomende geval), maar u kunt ook versie, openbare-sleuteltoken of cultuur (of een combinatie van de vier, maar niet alle vier) opnemen. De partialName moet overeenkomen met de naam die in uw gesprek is opgegeven. U kunt bijvoorbeeld niet opgeven "math" als het kenmerk partialName in uw configuratiebestand en uw code aanroepen Assembly.Load("math, Version=3.3.3.3") .

Voorbeeld

In het volgende voorbeeld wordt de aanroep Assembly.Load("math") logisch omgezet 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>

Share via