Teilen über


<qualifyAssembly>-Element

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>  

Siehe auch