<codeBase>-Element

Artikel
06/05/2023

Gibt an, wo die Common Language Runtime eine Assembly finden kann.

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <codeBase>

Syntax

   <codeBase
        version="Assembly version"
        href="URL of assembly"/>

Attribute und Elemente

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

Attribute

attribute	Beschreibung
`href`	Erforderliches Attribut. Gibt die URL an, unter der die Runtime die angegebene Version der Assembly finden kann.
`version`	Erforderliches Attribut. Gibt die Version der Assembly an, auf die die Codebasis angewendet wird. Das Format von Assemblyversionsnummern ist Hauptversion.Nebenversion.Build.Revision.

Attribut „version“

Wert	BESCHREIBUNG
Gültige Werte für jeden Teil dieser Versionsnummer sind 0 bis 65535.	Nicht zutreffend

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`buildproviders`	Definiert eine Auflistung von Buildanbietern, die zum Kompilieren benutzerdefinierter Ressourcendateien verwendet werden. Sie können eine beliebige Anzahl von Buildanbietern verwenden.
`compilation`	Konfiguriert alle Kompilierungseinstellungen, die ASP.NET verwendet.
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`System.web`	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Damit die Runtime die <codeBase-Einstellung> in einer Computerkonfigurationsdatei oder Herausgeberrichtliniendatei verwenden kann, muss die Datei auch die Assemblyversion umleiten. Anwendungskonfigurationsdateien können über eine Codebasiseinstellung verfügen, ohne die Assemblyversion umzuleiten. Nachdem die Runtime bestimmt hat, welche Assemblyversion verwendet werden soll, wendet sie die Codebasiseinstellung aus der Datei an, die die Version bestimmt. Wenn keine Codebasis angegeben ist, sucht die Runtime auf die übliche Weise nach Assemblys.

Wenn die Assembly einen starken Namen hat, kann sich die Codebasiseinstellung an einer beliebigen Stelle im lokalen Intranet oder im Internet befinden. Wenn es sich bei der Assembly um eine private Assembly handelt, muss die Codebasiseinstellung ein relativer Pfad zum Anwendungsverzeichnis sein.

Für Assemblys ohne starken Namen wird die Version ignoriert, und das Ladeprogramm verwendet das Vorkommen der <Codebasis> in <dependentAssembly>. Wenn in der Anwendungskonfigurationsdatei ein Eintrag vorhanden ist, der die Bindung an eine andere Assembly umleitet, hat die Umleitung auch dann Vorrang, wenn die Assemblyversion nicht mit der Bindungsanforderung übereinstimmt.

Beispiel

Im folgenden Beispiel wird gezeigt, wie angegeben wird, wo die Runtime eine Assembly finden kann.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>