References.Add, méthode

Article
08/21/2007

Ajoute une nouvelle référence au projet.

Espace de noms: VSLangProj
Assembly : VSLangProj (dans vslangproj.dll)

Syntaxe

'Déclaration
'Utilisation

Paramètres

bstrPath
Obligatoire. Chemin d'accès d'une référence COM ou .NET Framework.

Ce paramètre peut prendre trois formes :
- Nom d'objet .NET Framework simple, tel que "System".
- Nom de fichier .NET Framework (fichier .tlb, .dll ou .ocx).
- Fichier bibliothèque COM (fichier .tlb, .dll, .ocx ou .exe). Pour les objets COM, le chemin d'accès doit être constitué d'un chemin complet et d'un nom de fichier, par exemple "D:\Application\App.dll". Consultez la section "Références COM", plus loin dans cette rubrique, pour connaître les restrictions à l'ajout de références à un fichier .exe COM.

Valeur de retour

Retourne un objet Reference.

Notes

Une erreur est générée si aucune bibliothèque de types ne se trouve dans le fichier indiqué par le paramètre bstrPath ou si la référence n'a pas pu être résolue (consultez la section Résolution de référence).

Cette méthode ne génère pas d'erreur s'il existe dans le projet une référence dotée des mêmes propriétés Identity, Culture, MajorVersion, MinorVersion, BuildNumber et RevisionNumber que celles de la nouvelle référence. Cette condition indiquerait que la référence désignée par le paramètre bstrPath a déjà été ajoutée au projet. Dans ce cas, le ProjectItem de la référence déjà présente dans le projet est retourné.

Si une référence dotée de la même propriété Identity mais de propriétés MajorVersion, MinorVersion, BuildNumber, RevisionNumber ou Culture différentes est trouvée dans le projet, la méthode génère une erreur.

Pour supprimer une référence, utilisez le Remove.

Exemple

' Macro Editor
Imports VSLangProj
Sub AddExample()
   ' This example assumes that the first project in the solution is 
   ' either a Visual Basic or C# project.
   Dim aVSProject As VSProject = _
      CType(DTE.Solution.Projects.Item(1).Object, VSProject)
        
   Dim refs As References = aVSProject.References
   ' Adds a reference to a compiled .NET project.
   refs.Add("C:\path\program.dll")
   ' Adds a reference to an installed ActiveX control.
   refs.Add("C:\WINNT\system32\msmask32.ocx")
   ' Adds a reference to System.dll as an example of adding a
   ' reference using just the simple name.
   refs.Add("System")
End Sub

Voir aussi

Référence

References, interface
Membres References
VSLangProj, espace de noms

Share via