<assemblyIdentity>-Element für <runtime>

Artikel
06/05/2023

Enthält identifizierende Informationen zur Assembly.

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <assemblyIdentity>

Syntax

   <assemblyIdentity
name="assembly name"  
publicKeyToken="public key token"  
culture="assembly culture"/>

Attribute und Elemente

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

Attribute

attribute	Beschreibung
`name`	Erforderliches Attribut. Der Name der Assembly
`culture`	Optionales Attribut. Eine Zeichenfolge, die die Sprache und das Land bzw. die Region der Assembly angibt.
`publicKeyToken`	Optionales Attribut. Ein Hexadezimalwert, der den freigegebenen Namen der Assembly angibt.
`processorArchitecture`	Optionales Attribut. Einer der Werte „x86“, „amd64“, „msil“ oder „ia64“, der die Prozessorarchitektur für eine Assembly angibt, die prozessorspezifischen Code enthält. Bei den Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn dem Attribut ein anderer Wert zugewiesen ist, wird das gesamte `<assemblyIdentity>`-Element ignoriert. Siehe ProcessorArchitecture.

processorArchitecture-Attribut

Wert	Beschreibung
`amd64`	Nur die AMD x86-64-Architektur.
`ia64`	Nur die Intel Itanium-Architektur.
`msil`	Neutral hinsichtlich des Prozessors und der Bits pro Wort.
`x86`	Ein 32-Bit-x86-Prozessor, entweder nativ oder in der WOW-Umgebung (Windows on Windows) auf einer 64-Bit-Plattform.

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.
`dependentAssembly`	Kapselt die Bindungsrichtlinie und den Assemblyspeicherort für jede Assembly. Verwenden Sie für jede Assembly ein `<dependentAssembly>`-Element.
`runtime`	Enthält Informationen über die Assemblybindung und die Garbage Collection.

Bemerkungen

Jedes <dependentAssembly>-Element muss über ein untergeordnetes <assemblyIdentity>-Element verfügen.

Wenn das Attribut processorArchitecture vorhanden ist, gilt das <assemblyIdentity>-Element nur für die Assembly mit der entsprechenden Prozessorarchitektur. Wenn das processorArchitecture-Attribut nicht vorhanden ist, kann das <assemblyIdentity>-Element auf eine Assembly mit einer beliebigen Prozessorarchitektur angewendet werden.

Das folgende Beispiel zeigt eine Konfigurationsdatei für zwei Assemblys mit demselben Namen, der auf zwei verschiedene Prozessorarchitekturen ausgerichtet ist und deren Versionen nicht synchron verwaltet wurden. Wenn die Anwendung auf der x86-Plattform ausgeführt wird, gilt das erste <assemblyIdentity>-Element und das andere wird ignoriert. Wenn die Anwendung auf einer anderen Plattform als x86 oder ia64 ausgeführt wird, werden beide ignoriert.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"  
                  processorArchitecture="x86" />  
            <bindingRedirect oldVersion= "1.0.0.0"
                  newVersion="1.1.0.0" />  
         </dependentAssembly>  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"
                  processorArchitecture="ia64" />  
            <bindingRedirect oldVersion="1.0.0.0"
                  newVersion="2.0.0.0" />  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Wenn eine Konfigurationsdatei ein <assemblyIdentity>-Element ohne processorArchitecture-Attribut enthält und kein Element enthält, das der Plattform entspricht, wird das Element ohne das Attribut processorArchitecture verwendet.

Beispiel

Das folgende Beispiel zeigt, wie Informationen zu einer Assembly bereitgestellt werden.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="myAssembly"  
                              publicKeyToken="32ab4ba45e0a69a1"  
                              culture="neutral" />  
            <!--Redirection and codeBase policy for myAssembly.-->  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>