Metodo References.Add

Articolo
08/22/2007

Aggiunge un nuovo riferimento al progetto.

Spazio dei nomi: VSLangProj
Assembly: VSLangProj (in vslangproj.dll)

Sintassi

'Dichiarazione
'Utilizzo

Parametri

bstrPath
Obbligatorio. Il percorso di un riferimento COM o .NET Framework.

Questo parametro può assumere tre forme:
- Un semplice nome di oggetto .NET Framework, come "System".
- Un nome di file di .NET Framework (file tlb, dll o ocx).
- Un file di libreria COM (file tlb, dll, ocx o exe). Nel caso degli oggetti COM, il percorso deve comprendere un percorso e un nome file completi, ad esempio, "D:\SomeApplication\SomeApp.dll". Vedere le restrizioni relative all’aggiunta di riferimenti a file exe COM nella sezione "Riferimenti COM" descritta più avanti.

Valore restituito

Restituisce un oggetto Reference.

Note

Viene generato un errore qualora non siano presenti librerie dei tipi nel file indicato dal parametro bstrPath o qualora il riferimento non possa essere risolto (vedere la sezione Risoluzione dei riferimenti).

Questo metodo non genera un errore se nel progetto esiste un riferimento con le stesse proprietà Identity, Culture, MajorVersion, MinorVersion, BuildNumber e RevisionNumber del nuovo riferimento. Tale condizione mostra che il riferimento indicato dal parametro bstrPath è già stato aggiunto al progetto. Al contrario, viene restituito il ProjectItem per il riferimento corrispondente che è già contenuto nel progetto.

Se nel progetto è presente un riferimento con la stessa proprietà Identity ma con proprietà MajorVersion, MinorVersion, BuildNumber, RevisionNumber o Culture differenti, il metodo genera un errore.

Per rimuovere un riferimento, utilizzare Remove.

Esempio

' 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

Vedere anche

Riferimenti

Interfaccia References
Membri References
Spazio dei nomi VSLangProj

Condividi tramite