Élément <codeBase>

Article
05/09/2023

Spécifie l’emplacement où le CLR (Common Language Runtime) peut trouver un assembly.

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

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`href`	Attribut requis. Spécifie l’URL où le runtime peut trouver la version spécifiée de l’assembly.
`version`	Attribut requis. Spécifie la version de l’assembly à laquelle le codebase s’applique. Le format d’un numéro de version d’assembly est major.minor.build.revision.

Attribut version

Valeur	Description
Les valeurs valides pour chaque partie du numéro de version vont de 0 à 65535.	Non applicable.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
`buildproviders`	Définit une collection de fournisseurs de générations utilisés pour compiler des fichiers de ressources personnalisés. Le nombre de fournisseurs de générations n'est pas défini.
`compilation`	Configure tous les paramètres de compilation utilisés par ASP.NET.
`configuration`	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
`System.web`	Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

Pour que le runtime utilise le paramètre <codeBase> dans un fichier de configuration de machine ou un fichier de stratégie d’éditeur, le fichier doit également rediriger la version de l’assembly. Les fichiers de configuration d’application peuvent comporter un paramètre codebase sans rediriger la version de l’assembly. Après avoir déterminé la version de l’assembly à utiliser, le runtime applique le paramètre codebase du fichier qui détermine la version. Si aucun paramètre codebase n’est indiqué, le runtime recherche l’assembly de la manière habituelle.

Si l’assembly possède un nom fort, le paramètre codebase peut se trouver n’importe où sur l’intranet local ou sur Internet. Si l’assembly est privé, le paramètre codebase doit être un chemin relatif au répertoire de l’application.

Pour les assemblys qui ne possèdent pas de nom fort, la version est ignorée et le chargeur utilise la première occurrence du paramètre <codebase> dans <dependentAssembly>. Si le fichier de configuration d’application comporte une entrée qui redirige la liaison vers un autre assembly, la redirection est prioritaire même si la version de l’assembly ne correspond pas à la demande de liaison.

Exemple

L’exemple suivant montre comment spécifier où le runtime peut trouver un assembly.

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