Partager via

<assemblyBinding>, élément

  • Article

Contient des informations sur la redirection des versions des assemblys et sur l'emplacement de ces derniers.

<configuration>, élément
  <runtime>, élément
    <assemblyBinding>, élément

<assemblyBinding  
   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
</assemblyBinding>

Attributs et éléments

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

Attributs

Attribut Description

xmlns

Attribut requis.

Spécifie l'espace de noms XML requis pour les liaisons d'assembly. Utilisez la chaîne "urn:schemas-microsoft-com:asm.v1" comme valeur.

appliesTo

Attribut requis.

Spécifie la version du runtime à laquelle s'applique la redirection de l'assembly .NET Framework. Cet attribut facultatif utilise un numéro de version du .NET Framework pour indiquer la version à laquelle il s'applique. Si aucun attribut appliesTo n'est spécifié, l'élément <assemblyBinding> s'applique à toutes les versions du .NET Framework. L'attribut appliesTo a été introduit dans le .NET Framework version 1.1 ; il est ignoré par le .NET Framework version 1.0. Cela signifie que tous les éléments <assemblyBinding> sont appliqués lorsque vous utilisez le .NET Framework version 1.0, même si un attribut appliesTo est spécifié.

Éléments enfants

Élément Description

<dependentAssembly>

Encapsule la stratégie de liaisons et l'emplacement d'un assembly. Utilisez une balise <dependentAssembly> pour chaque assembly.

<probing>

Spécifie les sous-répertoires dans lesquels le Common Language Runtime effectue sa recherche lorsqu'il charge les assemblys.

<publisherPolicy>

Spécifie si le runtime applique la stratégie de l'éditeur.

<qualifyAssembly>

Spécifie le nom complet de l'assembly qui doit être chargé dynamiquement lorsqu'un nom partiel est utilisé.

Éléments parents

Élément Description

configuration

Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

runtime

Contient des informations sur les liaisons d'assembly et l'opération garbage collection.

Exemple

L'exemple suivant montre comment rediriger une version d'assembly vers une autre et fournir un paramètre codebase.

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

L'exemple suivant montre comment utiliser l'attribut appliesTo pour rediriger la liaison d'un assembly .NET Framework.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly> 
               <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>
                <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Voir aussi

Référence

Schéma des paramètres d'exécution

Concepts

Redirection des versions d'assemblys

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework