References.Add (Método)

Agrega una nueva referencia al proyecto.

Espacio de nombres: VSLangProj
Ensamblado: VSLangProj (en vslangproj.dll)

Sintaxis

'Declaración
'Uso

Parámetros

• bstrPath
  Necesario. Ruta de acceso de una referencia COM o .NET Framework.

  Este parámetro puede tomar tres formas:

  • Un nombre de objeto sencillo de .NET Framework, como "System".

  • Un nombre de archivo de .NET Framework (archivo .tlb, .dll u .ocx).

  • Un archivo de biblioteca COM (archivo .tlb, .dll, .ocx o .exe). Para los objetos COM, esta ruta de acceso debe incluir la ruta y el nombre de archivo completos, como "D:\SomeApplication\SomeApp.dll". Vea las restricciones existentes en la sección "Referencias COM" más adelante, que indica cómo agregar referencias de archivo .exe de COM.

Valor devuelto

Devuelve un objeto Reference.

Comentarios

Se genera un error si no hay bibliotecas de tipos en el archivo indicado por el parámetro bstrPath o no se puede resolver la referencia (vea la sección Resolución de referencias).

Este método no genera un error si existe una referencia en el proyecto con las mismas propiedades Identity, Culture, MajorVersion, MinorVersion, BuildNumber y RevisionNumber que tendría la nueva referencia. En tal caso, ello indicaría que la referencia señalada en el parámetro bstrPath ya se había agregado al proyecto. En su lugar, se devuelve el objeto ProjectItem de la referencia coincidente que ya existe en el proyecto.

Si se encuentra en el proyecto una referencia con la misma propiedad Identity pero con distinta propiedad MajorVersion, MinorVersion, BuildNumber, RevisionNumber o Culture, el método genera un error.

Para quitar una referencia, utilice el método Remove.

Ejemplo

' 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

Vea también

Referencia

References (Interfaz)
References (Miembros)
VSLangProj (Espacio de nombres)