Procédure : Activer et désactiver la redirection de liaison automatiqueHow to: Enable and Disable Automatic Binding Redirection

Lorsque vous compilez des applications dans Visual Studio qui ciblent le .NET Framework 4.5.1 et versions ultérieures, les redirections de liaison peuvent être automatiquement ajoutées au fichier de configuration d’application pour remplacer l’unification d’assembly.When you compile apps in Visual Studio that target the .NET Framework 4.5.1 and later versions, binding redirects may be automatically added to the app configuration file to override assembly unification. Les redirections de liaison sont ajoutées si votre application ou ses composants font référence à plusieurs versions du même assembly, même si vous spécifiez manuellement des redirections de liaison dans le fichier de configuration de votre application.Binding redirects are added if your app or its components reference more than one version of the same assembly, even if you manually specify binding redirects in the configuration file for your app. La fonctionnalité de redirection de liaison automatique affecte les applications web et les applications de bureau qui ciblent le .NET Framework 4.5.1 ou version ultérieure, bien que le comportement est légèrement différent pour une application web.The automatic binding redirection feature affects desktop apps and web apps that target the .NET Framework 4.5.1 or a later version, although the behavior is slightly different for a web app. Vous pouvez activer la redirection de liaison automatique si vous avez des applications existantes qui ciblent des versions précédentes du .NET Framework, ou vous pouvez désactiver cette fonctionnalité si vous souhaitez créer manuellement des redirections de liaison.You can enable automatic binding redirection if you have existing apps that target previous versions of the .NET Framework, or you can disable this feature if you want to manually author binding redirects.

Désactiver les redirections de liaison automatiques dans les applications de bureauDisable automatic binding redirects in desktop apps

Redirections de liaison automatiques sont activées par défaut pour les applications de bureau Windows qui ciblent le .NET Framework 4.5.1 et versions ultérieures.Automatic binding redirects are enabled by default for Windows desktop apps that target the .NET Framework 4.5.1 and later versions. Les redirections de liaison sont ajoutées à la configuration de sortie (app.config) du fichier lorsque l’application est compilée et remplacer l’unification d’assembly qui peut avoir lieu.The binding redirects are added to the output configuration (app.config) file when the app is compiled and override the assembly unification that might otherwise take place. La source de app.config fichier n’est pas modifié.The source app.config file is not modified. Vous pouvez désactiver cette fonctionnalité en modifiant le fichier projet pour l’application ou en désactivant une case à cocher dans les propriétés du projet dans Visual Studio.You can disable this feature by modifying the project file for the app or by deselecting a checkbox in the project's properties in Visual Studio.

Désactivation de via les propriétés du projetDisable through project properties

Si vous avez Visual Studio 2017 version 15.7 ou version ultérieure, vous pouvez facilement désactiver les redirections de liaison généré automatiquement dans les pages de propriétés du projet.If you have Visual Studio 2017 version 15.7 or later, you can easily disable autogenerated binding redirects in the project's property pages.

  1. Cliquez avec le bouton droit sur le projet dans l’Explorateur de solutions, puis sélectionnez Propriétés.Right-click the project in Solution Explorer and select Properties.

  2. Sur le Application page, désactivez le générer automatiquement des redirections de liaison option.On the Application page, uncheck the Auto-generate binding redirects option.

  3. Appuyez sur Ctrl+S pour enregistrer la modification.Press Ctrl+S to save the change.

Désactiver manuellement dans le fichier projetDisable manually in the project file

  1. Ouvrez le fichier de projet pour la modification à l’aide d’une des méthodes suivantes :Open the project file for editing using one of the following methods:

    • Dans Visual Studio, sélectionnez le projet dans l’Explorateur de solutions, puis choisissez ouvrir le dossier dans l’Explorateur de fichiers dans le menu contextuel.In Visual Studio, select the project in Solution Explorer, and then choose Open Folder in File Explorer from the shortcut menu. Dans l’Explorateur de fichiers, recherchez le fichier de projet (.csproj ou .vbproj) et ouvrez-le dans le bloc-notes.In File Explorer, find the project (.csproj or .vbproj) file and open it in Notepad.
    • Dans Visual Studio, dans l’Explorateur de solutions, cliquez sur le projet et choisissez décharger le projet.In Visual Studio, in Solution Explorer, right-click the project and choose Unload Project. Cliquez de nouveau sur le projet déchargé, puis choisissez modifier [NomProjet.csproj] .Right-click the unloaded project again, and then choose Edit [projectname.csproj].
  2. Dans le fichier projet, recherchez l'entrée de propriété suivante :In the project file, find the following property entry:

    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    
  3. Remplacez true par false :Change true to false:

    <AutoGenerateBindingRedirects>false</AutoGenerateBindingRedirects>
    

Activer manuellement des redirections de liaison automatiquesEnable automatic binding redirects manually

Vous pouvez activer les redirections de liaison automatiques dans les applications existantes qui ciblent des versions antérieures du .NET Framework, ou dans les cas où vous n’êtes pas automatiquement invité à ajouter une redirection.You can enable automatic binding redirects in existing apps that target older versions of the .NET Framework, or in cases where you're not automatically prompted to add a redirect. Si vous ciblez une version plus récente du framework mais ne pas automatiquement invité à ajouter une redirection, vous obtiendrez probablement un résultat de build qui suggère de que remapper les assemblys.If you're targeting a newer version of the framework but do not get automatically prompted to add a redirect, you'll likely get build output that suggests you remap assemblies.

  1. Ouvrez le fichier de projet pour la modification à l’aide d’une des méthodes suivantes :Open the project file for editing using one of the following methods:

    • Dans Visual Studio, sélectionnez le projet dans l’Explorateur de solutions, puis choisissez ouvrir le dossier dans l’Explorateur de fichiers dans le menu contextuel.In Visual Studio, select the project in Solution Explorer, and then choose Open Folder in File Explorer from the shortcut menu. Dans l’Explorateur de fichiers, recherchez le fichier de projet (.csproj ou .vbproj) et ouvrez-le dans le bloc-notes.In File Explorer, find the project (.csproj or .vbproj) file and open it in Notepad.
    • Dans Visual Studio, dans l’Explorateur de solutions, cliquez sur le projet et choisissez décharger le projet.In Visual Studio, in Solution Explorer, right-click the project and choose Unload Project. Cliquez de nouveau sur le projet déchargé, puis choisissez modifier [NomProjet.csproj] .Right-click the unloaded project again, and then choose Edit [projectname.csproj].
  2. Ajoutez l’élément suivant pour le premier groupe de propriétés de configuration (sous le <PropertyGroup > balise) :Add the following element to the first configuration property group (under the <PropertyGroup> tag):

    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    

    Voici un exemple de fichier de projet avec l’élément inséré :The following shows an example project file with the element inserted:

    <?xml version="1.0" encoding="utf-8"?>
    <Project ToolsVersion="12.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
      <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
        <PropertyGroup>
          <Configuration Condition=" '$(Configuration)' == ''     ">Debug</Configuration>
          <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
          <ProjectGuid>{123334}</ProjectGuid>
          ...
          <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
        </PropertyGroup>
      ...
    </Project>
    
  3. Compilez votre application.Compile your app.

Activer les redirections de liaison automatiques dans les applications webEnable automatic binding redirects in web apps

Les redirections de liaison automatiques sont implémentées différemment pour les applications web.Automatic binding redirects are implemented differently for web apps. Étant donné que la configuration de la source (web.config) fichier doit être modifié pour les applications web, les redirections de liaison ne sont pas automatiquement ajoutées au fichier de configuration.Because the source configuration (web.config) file must be modified for web apps, binding redirects are not automatically added to the configuration file. Toutefois, Visual Studio vous informe des éventuels conflits de liaison et vous pouvez ajouter des redirections de liaison pour résoudre ces conflits.However, Visual Studio notifies you of binding conflicts, and you can add binding redirects to resolve the conflicts. Étant donné que vous êtes toujours invité à ajouter des redirections de liaison, vous n’avez pas besoin de désactiver explicitement cette fonctionnalité pour une application web.Because you're always prompted to add binding redirects, you don't need to explicitly disable this feature for a web app.

Pour ajouter des redirections de liaison à un web.config fichier :To add binding redirects to a web.config file:

  1. Dans Visual Studio, compilez l'application et vérifiez les avertissements sur la génération.In Visual Studio, compile the app, and check for build warnings.

    Générer l’avertissement pour les conflits de référence d’assemblyBuild warning for assembly reference conflicts

  2. En cas de conflit de liaison d’assembly, un avertissement s’affiche.If there are assembly binding conflicts, a warning appears. Double-cliquez sur l’avertissement, ou sélectionnez l’avertissement et appuyez sur entrée.Double-click the warning, or select the warning and press Enter.

    Une boîte de dialogue qui vous permet d’ajouter automatiquement la liaison nécessaires redirige vers la source web.config fichier s’affiche.A dialog box that enables you to automatically add the necessary binding redirects to the source web.config file appears.

    Boîte de dialogue liaison de redirection autorisationBinding redirect permission dialog

Voir aussiSee also