Reference2 (Interfaz)

Artículo
08/10/2011

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.Sólo lectura. (Se hereda de Reference).
	BuildNumber	Obtiene el número de compilación de la referencia.Sólo lectura.
	Collection	Obtiene la colección que contiene el objeto compatible con esta propiedad o existente en esta construcción de código. (Se hereda de Reference).
	Collection	Obtiene una colección de References.
	ContainingProject	Obtiene el proyecto del cual forma parte el elemento seleccionado.Sólo lectura. (Se hereda de Reference).
	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. (Se hereda de Reference).
	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.Sólo lectura. (Se hereda de Reference).
	Culture	Obtiene la cadena de referencia cultural de una referencia.Sólo lectura.
	Description	Obtiene una descripción de texto de la referencia.Sólo lectura. (Se hereda de Reference).
	Description	Obtiene una descripción de texto de la referencia.Sólo lectura.
	DTE	Obtiene el objeto de extensibilidad de nivel superior. (Se hereda de Reference).
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	Extender[String]	Obtiene el objeto Extender solicitado si está disponible para este objeto. (Se hereda de Reference).
	Extender[String]	Devuelve el objeto Extender solicitado si está disponible para este objeto.
	ExtenderCATID	Obtiene el identificador de categoría (CATID) del objeto Extender. (Se hereda de Reference).
	ExtenderCATID	Obtiene el identificador de categoría (CATID) del objeto Extender.
	ExtenderNames	Obtiene una lista de los objetos Extender disponibles para el objeto. (Se hereda de Reference).
	ExtenderNames	Obtiene una lista de los objetos Extender disponibles para el objeto.
	Identity	Obtiene el identificador único de la referencia.Sólo lectura. (Se hereda de Reference).
	Identity	Obtiene el identificador único de la referencia.Sólo lectura.
	MajorVersion	Obtiene el número de versión principal de la referencia.Sólo lectura. (Se hereda de Reference).
	MajorVersion	Obtiene el número de versión principal de la referencia.Sólo lectura.
	MinorVersion	Obtiene el número de versión secundaria de la referencia.Sólo lectura. (Se hereda de Reference).
	MinorVersion	Obtiene el número de versión secundaria de la referencia.Sólo lectura.
	Name	Obtiene el nombre del objeto.Sólo lectura. (Se hereda de Reference).
	Name	Obtiene el nombre del objeto.Sólo lectura.
	Path	Obtiene la ruta de acceso del archivo de referencia.Sólo lectura. (Se hereda de Reference).
	Path	Obtiene la ruta de acceso del archivo de referencia.Sólo lectura.
	PublicKeyToken	Obtiene el token de la clave pública para el ensamblado al que se hace referencia. (Se hereda de Reference).
	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.Sólo lectura. (Se hereda de Reference).
	RevisionNumber	Obtiene el número de revisión de la referencia.Sólo lectura.
	RuntimeVersion	Obtiene y establece la versión del motor en tiempo de ejecución para la que se compiló la referencia.Sólo 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)).Sólo lectura. (Se hereda de Reference).
	SourceProject	Obtiene un objeto Project si la referencia es un proyecto.De lo contrario, devuelve Nothing (una referencia nullreferencia null (Nothing en Visual Basic)).Sólo lectura.
	StrongName	Obtiene si la referencia está firmada con un par de claves privada y pública.Sólo lectura. (Se hereda de Reference).
	StrongName	Obtiene si la referencia está firmada con un par de claves privada y pública.Sólo lectura.
	Type	Obtiene un valor prjReferenceType que indica si la referencia es un ensamblado o un componente COM.Sólo lectura. (Se hereda de Reference).
	Type	Obtiene un valor prjReferenceType que indica si la referencia es un ensamblado o un componente COM.Sólo lectura.
	Version	Obtiene la versión de la referencia seleccionada. (Se hereda de Reference).
	Version	Obtiene la versión de la referencia seleccionada.

Arriba

Métodos

	Nombre	Descripción
	Remove()	Obtiene la referencia del objeto References que lo contiene. (Se hereda de Reference).
	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)

Share via