<assemblyIdentity>-Element (Laufzeiteinstellungen)

Aktualisiert: November 2007

Enthält Identifizierungsinformationen für die Assembly.

<configuration>-Element
  <runtime>-Element
    <assemblyBinding>-Element für <runtime>
      <dependentAssembly>-Element
        <assemblyIdentity>-Element (Laufzeiteinstellungen)

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Erforderliches Attribut. Der Name der Assembly
culture	Optionales Attribut. Eine Zeichenfolge, die die Sprache sowie das Land bzw. die Region der Assembly angibt.
publicKeyToken	Optionales Attribut. Ein Hexadezimalwert, der den starken Namen der Assembly angibt.
processorArchitecture	Optionales Attribut. Einer der Werte "x86", "amd64", "msil" und "ia64". Er gibt die Prozessorarchitektur für eine Assembly an, die prozessorspezifischen Code enthält. Bei diesen Zeichen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn dem Attribut ein anderer Wert zugewiesen wird, dann wird das ganze <assemblyIdentity>-Element ignoriert. Weitere Informationen finden Sie unter ProcessorArchitecture.

ProcessorArchitecture-Attribut

Wert	Beschreibung
amd64	Nur ein 64-Bit-AMD-Prozessor.
ia64	Nur ein 64-Bit-Intel-Prozessor.
msil	Neutral in Bezug auf Prozessor und Bits pro Wort
x86	Ein 32-Bit-Intel-Prozessor, entweder systemeigen 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 Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
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.

Hinweise

Jedes <dependentAssembly>-Element muss ein untergeordnetes <assemblyIdentity>-Element aufweisen.

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

Das folgende Beispiel zeigt eine Konfigurationsdatei für zwei Assemblys mit dem gleichen Namen, die auf zwei verschiedene Dualprozessorarchitekturen abzielen und deren Versionen nicht synchron gehalten wurden. Wenn die Anwendung auf der x86-Plattform ausgeführt wird, gilt das erste <assemblyIdentity>-Element, und das andere wird ignoriert. Wird die Anwendung auf einer Plattform ausgeführt, die keine x86- oder ia64-Plattform ist, 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 processorArchitecture-Attribut verwendet.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie Informationen über eine Assembly bereitstellen.

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

Siehe auch

Konzepte

Umleiten von Assemblyversionen

Referenz

Schema für Laufzeiteinstellungen

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework