Dépanner des références rompuesTroubleshoot broken references

Si votre application tente d’utiliser une référence rompue, une erreur d’exception est générée.If your application attempts to use a broken reference, an exception error is generated. Si la première cause d’erreur est l’impossibilité de localiser le composant référencé, il existe toutefois plusieurs situations dans lesquelles une référence peut être considérée comme rompue.The inability to find the referenced component is the primary trigger for the error, but there are several situations in which a reference can be considered broken. Ces situations sont répertoriées dans la liste suivante :These instances are shown in the following list:

  • Le chemin de la référence du projet est incorrect ou incomplet.The project's reference path is incorrect or incomplete.

  • Le fichier référencé a été supprimé.The file being referenced has been deleted.

  • Le fichier référencé a été renommé.The file being referenced has been renamed.

  • La connexion réseau ou l’authentification a échoué.The network connection or authentication has failed.

  • La référence pointe vers un composant COM qui n’est pas installé sur l’ordinateur.The reference is to a COM component that is not installed on the computer.

Les solutions suivantes permettent de résoudre ces problèmes.The following are remedies to these problems.

Note

Les fichiers situés dans les assemblys sont référencés à l’aide de chemins absolus dans le fichier projet.Files in assemblies are referenced with absolute paths in the project file. Par conséquent, il est possible qu’un assembly référencé dans l’environnement local d’utilisateurs qui travaillent dans un environnement comprenant plusieurs développeurs soit manquant.Therefore, it is possible for users who work in a multideveloper environment to be missing a referenced assembly in their local environment. Pour éviter ces erreurs, il est préférable, dans ce cas, d’ajouter des références entre projets.To avoid these errors, it is better in these cases to add project-to-project references. Pour plus d’informations, consultez Programmation à l’aide d’assemblys.For more information, see Programming with assemblies.

Le chemin de la référence est incorrectReference path is incorrect

Si les projets sont partagés sur différents ordinateurs, certaines références peuvent être introuvables quand un composant se trouve dans un répertoire différent sur chaque ordinateur.If projects are shared on different computers, some references might not be found when a component is located in a different directory on each computer. Les références sont stockées sous le nom du fichier du composant (par exemple, MyComponent).References are stored under the name of the component file (for example, MyComponent). Lors de l’ajout d’une référence à un projet, l’emplacement de dossier du fichier de composant (par exemple, C:\MyComponents) est ajouté à la propriété de projet ReferencePath.When a reference is added to a project, the folder location of the component file (for example, C:\MyComponents) is appended to the ReferencePath project property.

À son ouverture, le projet tente de localiser ces fichiers de composant référencés en effectuant une recherche dans les répertoires situés dans le chemin de la référence.When the project is opened, it attempts to locate these referenced component files by looking in the directories on the reference path. S’il est ouvert sur un ordinateur qui stocke le composant dans un autre répertoire, par exemple D:\MyComponents, la référence est introuvable et une erreur s’affiche dans la Liste des tâches.If the project is opened on a computer that stores the component in a different directory, such as D:\MyComponents, the reference cannot be found and an error appears in the Task List.

Pour résoudre ce problème, vous pouvez supprimer la référence rompue, puis la remplacer à l’aide de la boîte de dialogue Ajouter une référence.To fix this problem, you can delete the broken reference and then replace it using the Add Reference dialog box. Une autre solution consiste à utiliser l’élément Chemins d’accès de références dans les pages de propriétés du projet et à modifier les dossiers de la liste afin qu’ils pointent vers les emplacements corrects.Another solution is to use the Reference Path item in the project's property pages and modify the folders in the list to point to the correct locations. La propriété Chemin d’accès de référence est rendue persistante pour chaque utilisateur de chaque ordinateur.The Reference Path property is persisted for each user on each computer. Par conséquent, la modification du chemin de votre référence n’affecte pas les autres utilisateurs du projet.Therefore, modifying your reference path does not affect other users of the project.

Conseil

Ces problèmes ne se posent pas pour les références entre projets.Project-to-project references do not have these problems. Par conséquent, utilisez-les plutôt que les références de fichier, si vous le pouvez.For this reason, use them instead of file references, if you can.

Pour réparer une référence de projet rompue en corrigeant son cheminTo fix a broken project reference by correcting the reference path

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud de votre projet, puis cliquez sur Propriétés.In Solution Explorer, right-click your project node and click Properties.

    Le Concepteur de projet s’affiche.The Project Designer appears.

  2. Si vous utilisez Visual Basic, sélectionnez la page Références, puis cliquez sur le bouton Chemins d’accès des références.If you are using Visual Basic, select the References page and click the Reference Paths button. Dans la boîte de dialogue Chemins d’accès des références, tapez le chemin du dossier contenant l’élément que vous voulez référencer dans le champ Dossier, puis cliquez sur le bouton Ajouter un dossier.In the Reference Paths dialog box, type the path of the folder that contains the item you want to reference in the Folder field, and then click the Add Folder button.

    Si vous utilisez C#, sélectionnez la page Chemins d’accès des références.If you are using C#, select the Reference Paths page. Dans le champ Dossier, tapez le chemin du dossier contenant l’élément que vous voulez référencer, puis cliquez sur bouton Ajouter un dossier.In the Folder field, type the path of the folder that contains the item you want to reference, and then click the Add Folder button.

Le fichier référencé a été suppriméReferenced file has been deleted

Il est possible que le fichier référencé ait été supprimé et n’existe plus sur le lecteur.It is possible that the file being referenced has been deleted and no longer exists on the drive.

Pour réparer une référence de projet rompue pour un fichier qui n’existe plus sur le lecteurTo fix a broken project reference for a file that no longer exists on your drive

  • Supprimez la référence.Delete the reference.

  • Si la référence existe dans un autre emplacement sur votre ordinateur, lisez-la à partir de cet emplacement.If the reference exists in another location on your computer, read it from that location.

Le fichier référencé a été renomméReferenced file has been renamed

Il est possible que le fichier référencé ait été renommé.It is possible that the file being referenced has been renamed.

Pour réparer une référence rompue d’un fichier qui a été renomméTo fix a broken reference for a file that has been renamed

  • Supprimez la référence, puis ajoutez une référence au fichier renommé.Delete the reference, and then add a reference to the renamed file.

  • Si la référence existe dans un autre emplacement sur votre ordinateur, vous devez la lire à partir de cet emplacement.If the reference exists in another location on your computer, you have to read it in from that location.

La connexion réseau ou l’authentification a échouéNetwork connection or authentication has failed

Il peut exister quantité de raisons expliquant l’inaccessibilité des fichiers : un échec de la connexion réseau ou de l’authentification, par exemple.There can be many possible causes for inaccessible files: a failed network connection or a failed authentication, for example. À chaque cause d’un problème peut être associée une solution unique ; par exemple, vous devrez peut-être contacter l’administrateur local pour qu’il vous donne accès aux ressources nécessaires.Each cause might have a unique means of recovery; for example, you might have to contact the local administrator for access to the required resources. Toutefois, il est toujours possible de supprimer la référence et de réparer le code qui l’utilise.However, deleting the reference and fixing the code which used it is always an option.

Le composant COM n’est pas installé sur l’ordinateurCOM component is not installed on computer

Si un utilisateur a ajouté une référence à un composant COM et qu’un second utilisateur tente d’exécuter le code sur un ordinateur sur lequel ce composant n’est pas installé, ce second utilisateur voit s’afficher un message d’erreur indiquant que la référence est rompue.If a user has added a reference to a COM component and a second user tries to run the code on a computer that does not have this component installed, the second user will receive an error that the reference is broken. Cette erreur peut être corrigée en installant le composant sur le second ordinateur.Installing the component on the second computer will correct the error. 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.For more information about how to use references to COM components in your projects, see COM interoperability in .NET Framework applications.

Voir aussiSee also