Résoudre les problèmes de références rompues

Article
03/21/2023

S’applique à : Visual Studio

Si votre application tente d’utiliser une référence rompue, une erreur d’exception est générée. La raison main de l’erreur est l’impossibilité de trouver le composant référencé, mais il existe plusieurs scénarios dans lesquels une référence est considérée comme rompue et sont :

Le chemin d’accès de référence de Project est incorrect ou incomplet.
Le fichier référencé a été supprimé.
Le fichier référencé a été renommé.
Échec de la connexion réseau ou de l’authentification.
Le composant COM référencé n’est pas installé sur l’ordinateur.

Les sections suivantes fournissent des solutions à ces scénarios.

Remarque

Les fichiers dans les assemblys sont référencés avec des chemins absolus dans le fichier projet. Par conséquent, les utilisateurs qui travaillent dans un environnement multi-développeur peuvent constater qu’il leur manque un assembly référencé dans leur environnement local. Pour éviter ces erreurs, il est préférable d’ajouter des références projet à projet. Pour plus d’informations, consultez Assemblys dans .NET.

Le chemin d’accès de référence est incorrect ou incomplet

Si les projets sont partagés sur différents ordinateurs, certaines références peuvent ne pas être trouvées lorsqu’un composant se trouve dans un répertoire différent. Les références sont stockées sous le nom du fichier de composant (par exemple, MyComponent). Lorsque vous ajoutez une référence à un projet, l’emplacement du dossier du fichier de composant (par exemple, C :\MyComponents) est ajouté à la propriété de projet ReferencePath .

Lorsque vous ouvrez un projet, Visual Studio recherche dans les répertoires le chemin d’accès de référence pour essayer de trouver ces fichiers de composants. Si vous ouvrez le projet sur un ordinateur qui stocke le composant dans un autre répertoire, tel que D :\MyComponents, la référence est introuvable et une erreur s’affiche dans la liste des tâches.

Pour résoudre ce problème, utilisez l’une des méthodes suivantes :

Supprimez la référence rompue, puis remplacez-la à l’aide de la boîte de dialogue Ajouter une référence .
Utilisez l’élément Chemin d’accès de référence dans les pages de propriétés du projet. Modifiez les dossiers de la liste pour qu’ils pointent vers les emplacements appropriés. La propriété Chemin d’accès de référence est conservée pour chaque utilisateur sur chaque ordinateur. Par conséquent, la modification de votre chemin d’accès de référence n’affecte pas les autres utilisateurs du projet.

Conseil

Les références de projet à projet n’ont pas ces problèmes de référence rompus. Pour cette raison, utilisez des références de projet à projet au lieu de références de fichier, si vous le pouvez.

Corriger une référence de projet rompue

Pour corriger une référence de projet rompue, corrigez le chemin d’accès de référence en procédant comme suit :

Dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de votre projet, puis sélectionnez Propriétés. Le Designer Project s’affiche.
Si vous utilisez Visual Basic, sélectionnez la page Références , puis sélectionnez Chemins d’accès de référence .
1. Dans la boîte de dialogue Chemins d’accès de référence , tapez le chemin du dossier qui contient l’élément que vous souhaitez référencer dans le champ Dossier .
2. Sélectionnez Ajouter un dossier.
Si vous utilisez C#, sélectionnez la page Chemins d’accès de référence .
1. Dans le champ Dossier , tapez le chemin du dossier qui contient l’élément que vous souhaitez référencer.
2. Sélectionnez Ajouter un dossier.

Le fichier référencé a été supprimé

Voici deux options pour corriger une référence de projet rompue pour un fichier supprimé qui n’existe plus sur votre lecteur :

Supprimez la référence.
Si la référence existe à un autre emplacement sur votre ordinateur, lisez-la à partir de cet emplacement.

Le fichier référencé a été renommé

Voici deux options pour corriger une référence rompue pour un fichier qui a été renommé :

Supprimez la référence, puis ajoutez une référence au fichier renommé.
Si la référence existe à un autre emplacement sur votre ordinateur, lisez-la à partir de cet emplacement.

Échec de la connexion réseau ou de l’authentification

Il peut y avoir de nombreuses causes possibles pour les fichiers inaccessibles. Par exemple, il peut y avoir un échec de connexion réseau ou une authentification. À l’inverse, chaque cause peut avoir un moyen de récupération unique. Par exemple, vous devrez peut-être contacter l’administrateur local pour accéder aux ressources requises. Toutefois, la suppression de la référence et la correction du code qui l’a utilisée sont toujours une option.

Le composant COM référencé n’est pas installé sur l’ordinateur

Si un utilisateur ajoute une référence à un composant COM et qu’un deuxième utilisateur tente d’exécuter le code sur un ordinateur sur lequel ce composant n’est pas installé, le deuxième utilisateur reçoit une erreur de référence rompue. L’installation du composant sur le deuxième ordinateur corrige l’erreur. Pour plus d’informations sur l’utilisation des références aux composants COM dans vos projets, consultez Interopérabilité COM dans les applications .NET Framework.