<qualifyAssembly>-Element

  • Artikel

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

<configuration>-Element
  <runtime>-Element
    <assemblyBinding>-Element
      <qualifyAssembly>-Element

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

Attribute und Elemente

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

Attribute

Attribut Beschreibung

partialName

Erforderliches Attribut.

Gibt den partiellen Namen der Assembly an, wie er im Code erscheint.

fullName

Erforderliches Attribut.

Gibt den vollständigen Namen der Assembly an, wie er im Code erscheint.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element Beschreibung

assemblyBinding

Enthält Informationen über die Assemblyversionsumleitung und die Speicherorte von Assemblys.

configuration

Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

runtime

Enthält Informationen über die Assemblybindung und die Garbage Collection.

Hinweise

Durch Aufrufen der Assembly.Load-Methode unter Verwendung von partiellen Assemblynamen sucht die Common Language Runtime nur im Basisverzeichnis der Anwendung nach der Assembly. Verwenden Sie das <qualifyAssembly>-Element in der Anwendungskonfigurationsdatei, um vollständige Informationen zur Assembly bereitzustellen (Name, Version, öffentliches Schlüsseltoken und Kultur) und zu veranlassen, dass die Common Language Runtime im globalen Assemblycache nach der Assembly sucht.

Das fullName-Attribut muss folgende vier Felder für die Identität der Assembly enthalten: Name, Version, öffentliches Schlüsseltoken und Kultur. Das partialName-Attribut muss partiell auf eine Assembly verweisen. Sie müssen zumindest den Textnamen der Assembly angeben (in den meisten Fällen), Sie können jedoch auch die Version, das öffentliche Schlüsseltoken oder die Kultur angeben (oder eine Kombination aus Elementen, aber nicht alle vier Elemente). Der partialName muss mit dem Namen übereinstimmen, der in dem Aufruf angegeben wird. Beispielsweise können Sie nicht "math" als partialName-Attribut in der 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>

Siehe auch

Referenz

Schema für Laufzeiteinstellungen

Konzepte

So sucht Common Language Runtime nach Assemblys
Partielle Assemblyverweise