<qualifyAssembly>-Element

Artikel
05/10/2023

Gibt den vollständigen Namen der Assembly an, die dynamisch geladen werden soll, wenn Sie ein Teilname verwendet wird.

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	Beschreibung
`partialName`	Erforderliches Attribut. Gibt den Teilnamen der Assembly an, wie er im Code angezeigt wird.
`fullName`	Erforderliches Attribut. Gibt den vollständigen Namen der Assembly an, wie er im globalen Assemblycache angezeigt wird.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`assemblyBinding`	Enthält Informationen über die Assemblyversionsumleitung und die Speicherorte von Assemblys.
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`runtime`	Enthält Informationen über die Assemblybindung und die Garbage Collection.

Bemerkungen

Durch das Aufrufen der Assembly.Load-Methode mithilfe von Assemblyteilnamen wird die Common Language Runtime veranlasst, nur im Anwendungsbasisverzeichnis nach der Assembly zu suchen. Verwenden Sie das <qualifyAssembly>-Element in Ihrer Anwendungskonfigurationsdatei, um die vollständigen Assemblyinformationen (Name, Version, öffentliches Schlüsseltoken und Kultur) bereitzustellen, und veranlassen Sie, dass die Common Language Runtime nach der Assembly im globalen Assemblycache sucht.

Das fullName-Attribut muss die vier Felder der Assemblyidentität enthalten: Name, Version, öffentliches Schlüsseltoken und Kultur. Das partialName-Attribut muss teilweise auf eine Assembly verweisen. Sie müssen mindestens den Textnamen der Assembly angeben (der häufigste Fall), aber Sie können auch die Version, das öffentliche Schlüsseltoken oder die Kultur (oder eine beliebige Kombination der vier, aber nicht alle vier) einschließen. Der partialName muss mit dem in Ihrem Aufruf angegebenen Namen übereinstimmen. Beispielsweise können Sie nicht "math" als partialName-Attribut in Ihrer Konfigurationsdatei angeben und Assembly.Load("math, Version=3.3.3.3") im Code aufrufen.

Beispiel

Im folgenden Beispiel wird der Aufruf Assembly.Load("math") logisch in Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral") umgewandelt.

<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>