Reference2 (Interfaz)

Extiende la interfaz Reference del espacio de nombres VSLangProj.

Espacio de nombres:  VSLangProj2
Ensamblado:  VSLangProj2 (en VSLangProj2.dll)

Sintaxis

'Declaración
<GuidAttribute("4FFF24C5-5644-4A47-A48A-B74C3F1F8FC8")> _
Public Interface Reference2 _
    Inherits Reference

[GuidAttribute("4FFF24C5-5644-4A47-A48A-B74C3F1F8FC8")]
public interface Reference2 : Reference

[GuidAttribute(L"4FFF24C5-5644-4A47-A48A-B74C3F1F8FC8")]
public interface class Reference2 : Reference

[<GuidAttribute("4FFF24C5-5644-4A47-A48A-B74C3F1F8FC8")>]
type Reference2 =  
    interface 
        interface Reference 
    end

public interface Reference2 extends Reference

El tipo Reference2 expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	BuildNumber	Obtiene el número de compilación de la referencia.Solo lectura.
	Collection	Obtiene una colección de References.
	ContainingProject	Obtiene el objeto Project que contiene la referencia.
	CopyLocal	Determina si se copia la referencia en la ruta de acceso de la bandeja local.
	Culture	Obtiene la cadena de referencia cultural de una referencia.Solo lectura.
	Description	Obtiene una descripción de texto de la referencia.Solo lectura.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	Extender	Devuelve el objeto Extender solicitado si está disponible para este objeto.
	ExtenderCATID	Obtiene el identificador de categoría (CATID) de extensor para el objeto.
	ExtenderNames	Obtiene una lista de los objetos Extender disponibles para el objeto.
	Identity	Obtiene el identificador único de la referencia.Solo lectura.
	MajorVersion	Obtiene el número de versión principal de la referencia.Solo lectura.
	MinorVersion	Obtiene el número de versión secundaria de la referencia.Solo lectura.
	Name	Obtiene el nombre del objeto.Solo lectura.
	Path	Obtiene la ruta de acceso del archivo de referencia.Solo lectura.
	PublicKeyToken	Obtiene el token de la clave pública para el ensamblado al que se hace referencia.
	RevisionNumber	Obtiene el número de revisión de la referencia.Solo lectura.
	RuntimeVersion	Obtiene y establece la versión del motor en tiempo de ejecución para la que se compiló la referencia.Solo lectura.
	SourceProject	Obtiene un objeto Project si la referencia es un proyecto.De lo contrario, devuelve Nothing (una referencia nullreferencia null (Nothing en Visual Basic)).Solo lectura.
	StrongName	Obtiene si la referencia está firmada con un par de claves privada y pública.Solo lectura.
	Type	Obtiene un valor prjReferenceType que indica si la referencia es un ensamblado o un componente COM.Solo lectura.
	Version	Obtiene la versión de la referencia seleccionada.

Arriba

Métodos

	Nombre	Descripción
	Remove	Quita la referencia del objeto References que la contiene.

Arriba

Comentarios

Objetos Reference devueltos por la colección References del objeto VSProject que aceptan las interfaces Reference y Reference2. Convierta el objeto a Reference2 para tener acceso a los miembros Reference2.

Reference2 define todos los miembros Reference del espacio de nombres VSLangProj, más:

• RuntimeVersion

Ejemplos

En el ejemplo siguiente se crea un nuevo proyecto a partir de una plantilla, se agregan dos referencias y se muestran sus tipos correspondientes.

'Macro Editor
Imports VSLangProj
Sub NewProject()
   Dim newName As String = InputBox("New project name:")
   ' Create a new project in the solution based on an existing
   ' project.
   Dim newProject As Project = DTE.Solution.AddFromTemplate( _
      "C:\TemplatePath\Template.vbproj", _
      "C:\ProjectPath\" & newName, newName)
        
   ' Add a COM reference and display its type.
   Dim vsProject As VSProject = CType(newProject.Object, VSProject)
   Dim newRef As Reference
   newRef = vsProject.References.Add("C:\WINNT\System32\msmask32.ocx")
   MsgBox(GetRefTypeName(newRef))
        
   ' Add an Assembly reference and display its type, "Assembly".
   newRef = vsProject.References.Add("C:\SomeProject\bin\SomeProject.dll")
   MsgBox(GetRefTypeName(newRef))
End Sub

Private Function GetRefTypeName(ByVal ref As Reference) _
   As String
   Dim type As String
   Select Case ref.Type
      Case prjReferenceType.prjReferenceTypeActiveX
         type = "COM"
      Case prjReferenceType.prjReferenceTypeAssembly
         type = "Assembly"
   End Select
   Return type
End Function

El ejemplo siguiente crea un breve informe con las propiedades de una referencia.

' Macro Editor
' Create a small report about a reference.
Imports VSLangProj
Function ReportReferences(ByVal aRef As Reference) As String
   Dim report As String = ""
   Dim type As String
   ' Each entry in the ArrayList will contain a label and a value.
   Dim ht As System.Collections.ArrayList = _
      New System.Collections.ArrayList()
   With aRef
      ht.Add(New String() {"Name", .Name})
      ht.Add(New String() {"Description", .Description})
      ht.Add(New String() {"Version", String.Format("{0}.{1}.{2}.{3}", _
         .MajorVersion, .MinorVersion, .BuildNumber, .RevisionNumber)})
      ht.Add(New String() {"Location", .ContainingProject.FullName})
      Select Case .Type
         Case prjReferenceType.prjReferenceTypeActiveX
            type = "COM"
         Case prjReferenceType.prjReferenceTypeAssembly
            type = "Assembly"
      End Select
      ht.Add(New String() {"Type", type})
      ht.Add(New String() {"Culture", .Culture})
   End With
        
   Dim datas() As String
   For Each datas In ht
      report &= datas(0) & ControlChars.Tab & datas(1) & ControlChars.CrLf
   Next
   Return report
End Function

Vea también

Referencia

VSLangProj2 (Espacio de nombres)