Dépanner des références rompues
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 principale raison de l’erreur est l’incapacité 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 les suivantes :
- Le chemin d’accès de référence du projet 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 résolutions pour ces scénarios.
Note
Les fichiers situés dans les assemblys sont référencés à l’aide de chemins absolus dans le fichier projet. Par conséquent, les utilisateurs qui travaillent dans un environnement multi-développeur peuvent constater qu’ils manquent un assembly référencé dans leur environnement local. Pour éviter ces erreurs, il est préférable d’ajouter des références entre projets. Pour plus d’informations, consultez Assemblys dans .NET.
Le chemin d’accès de référence est incorrect ou incomplet
Si des 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 autre répertoire. Les références sont stockées sous le nom du fichier du 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é du projet ReferencePath .
Lorsque vous ouvrez un projet, Visual Studio recherche dans les répertoires du 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 corriger 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 rendue persistante pour chaque utilisateur de chaque ordinateur. Par conséquent, la modification du chemin de votre 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 Project à projet au lieu de références de fichier, si vous le pouvez.
Correction d’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 l’Explorateur de solutions, faites un clic droit sur votre nœud de projet, puis sélectionnez Propriétés. Le Concepteur de projet 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.
- Dans la boîte de dialogue Chemins d’accès de référence, tapez le chemin d’accès du dossier qui contient l’élément que vous souhaitez référencer dans le champ Dossier .
- Sélectionnez Ajouter un dossier.
- Si vous utilisez C#, sélectionnez la page Chemins d’accès des références.
- Dans le champ Dossier , tapez le chemin d’accès du dossier qui contient l’élément que vous souhaitez référencer.
- 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 dans 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 dans un autre emplacement sur votre ordinateur, lisez-la à partir de cet emplacement.
La connexion réseau ou l’authentification a échoué
Il peut y avoir de nombreuses causes possibles pour les fichiers inaccessibles. Par exemple, il peut y avoir une connexion réseau ayant échoué ou une authentification ayant échoué. À 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, il est toujours possible de supprimer la référence et de réparer le code qui l’utilise.
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 de références aux composants COM dans vos projets, consultez Interopérabilité COM dans les applications .NET Framework.