<codeBase>-Element

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

<configuration>-Element
  <runtime>-Element
    <assemblyBinding>-Element
      <dependentAssembly>-Element
        <codeBase>-Element

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
href	Erforderliches Attribut. Gibt den URL an, unter dem die Runtime die angegebene Version der Assembly finden kann.
version	Erforderliches Attribut. Gibt die Versionsnummer der Assembly an, für die die CodeBase gilt. Das Format einer Assemblyversionsnummer lautet major.minor.build.revision.

version-Attribut

Wert	Beschreibung
Gültige Werte für jeden Abschnitt der 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 Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
System.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Damit die Runtime die <codeBase>-Einstellung in einer Computerkonfigurationsdatei oder einer Herausgeberrichtliniendatei verwendet, muss die Datei auch die Assemblyversion umleiten. Eine Anwendungskonfigurationsdatei kann eine CodeBase-Einstellung enthalten, ohne dass die Assemblyversion umgeleitet wird. Nachdem die Runtime ermittelt hat, welche Assemblyversion zu verwenden ist, wendet sie die CodeBase-Einstellung aus der Datei an, die die Version bestimmt. Wird keine CodeBase angegeben, sucht die Runtime auf die übliche Weise nach der Assembly.

Wenn die Assembly einen starken Namen hat, kann die CodeBase ein beliebiger Speicherort im lokalen Intranet oder im Internet sein. Ist die Assembly eine private Assembly, muss die CodeBase-Einstellung ein Pfad relativ zum Anwendungsverzeichnis sein.

Bei Assemblys ohne starken Namen wird die Version ignoriert und das Ladeprogramm verwendet das erstmalige Vorkommen von <codebase> innerhalb von <dependentAssembly>. Wenn ein Eintrag in der Anwendungskonfigurationsdatei vorliegt, der die Bindung an eine andere Assembly umleitet, hat die Umleitung Vorrang, selbst wenn die Assemblyversion nicht der Bindungsanforderung entspricht.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie angeben, 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>

Siehe auch

Referenz

Schema für Laufzeiteinstellungen

Konzepte

Festlegen des Speicherortes einer Assembly
So sucht Common Language Runtime nach Assemblys

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework