Élément <codeBase><codeBase> Element

Spécifie où le common language runtime peut trouver un assembly.Specifies where the common language runtime can find an assembly.

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

SyntaxeSyntax

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

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
href Attribut requis.Required attribute.

Spécifie l’URL où le runtime peut trouver la version spécifiée de l’assembly.Specifies the URL where the runtime can find the specified version of the assembly.
version Attribut requis.Required attribute.

Spécifie la version de l’assembly à laquelle s’applique le code base.Specifies the version of the assembly the codebase applies to. Le format d’un numéro de version d’assembly est major. minor. Build. Revision.The format of an assembly version number is major.minor.build.revision.

Attribut de versionversion Attribute

ValeurValue DescriptionDescription
Les valeurs valides pour chaque partie du numéro de version sont comprises entre 0 et 65535.Valid values for each part of the version number are 0 to 65535. Non applicable.Not applicable.

Éléments enfantsChild Elements

Aucun.None.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
buildproviders Définit une collection de fournisseurs de générations utilisés pour compiler des fichiers de ressources personnalisés.Defines a collection of build providers used to compile custom resource files. Le nombre de fournisseurs de générations n'est pas défini.You can have any number of build providers.
compilation Configure tous les paramètres de compilation utilisés par ASP.NET.Configures all the compilation settings that ASP.NET uses.
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
System.web Spécifie l'élément racine de la section de configuration ASP.NET.Specifies the root element for the ASP.NET configuration section.

RemarquesRemarks

Pour que le runtime utilise le <codeBase> paramètre dans un fichier de configuration machine ou un fichier de stratégie d’éditeur, le fichier doit également rediriger la version de l’assembly.For the runtime to use the <codeBase> setting in a machine configuration file or publisher policy file, the file must also redirect the assembly version. Les fichiers de configuration de l’application peuvent avoir un paramètre code base sans rediriger la version de l’assembly.Application configuration files can have a codebase setting without redirecting the assembly version. Après avoir déterminé la version de l’assembly à utiliser, le runtime applique le paramètre de code base du fichier qui détermine la version.After determining which assembly version to use, the runtime applies the codebase setting from the file that determines the version. Si aucun code base n’est indiqué, le runtime détecte l’assembly de la façon habituelle.If no codebase is indicated, the runtime probes for the assembly in the usual way.

Si l’assembly a un nom fort, le paramètre de code base peut se trouver n’importe où sur l’intranet local ou sur Internet.If the assembly has a strong name, the codebase setting can be anywhere on the local intranet or the Internet. Si l’assembly est un assembly privé, le paramètre de code base doit être un chemin d’accès relatif au répertoire de l’application.If the assembly is a private assembly, the codebase setting must be a path relative to the application's directory.

Pour les assemblys sans nom fort, la version est ignorée et le chargeur utilise la première apparence de <codebase> à l’intérieur de <dependentAssembly> .For assemblies without a strong name, version is ignored and the loader uses the first appearance of <codebase> inside <dependentAssembly>. S’il y a une entrée dans le fichier de configuration de l’application qui redirige la liaison vers un autre assembly, la redirection aura la priorité, même si la version de l’assembly ne correspond pas à la demande de liaison.If there is an entry in the application configuration file that redirects binding to another assembly, the redirection will take precedence even if the assembly version doesn't match the binding request.

ExempleExample

L’exemple suivant montre comment spécifier où le runtime peut trouver un assembly.The following example shows how to specify where the runtime can find an 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>

Voir aussiSee also