Interface Reference

Artigo
05/17/2015

Representa uma referência do projeto. Incluir uma referência em um projeto permite que você use qualquer um dos membros públicos contidos na referência. Projetos podem incluir referências a outros projetos de O, a assemblies .NET, e a objetos COM.

Namespace: VSLangProj
Assembly: VSLangProj (em VSLangProj.dll)

Sintaxe

'Declaração
<GuidAttribute("35D6FB50-35B6-4C81-B91C-3930B0D95386")> _
Public Interface Reference

[GuidAttribute("35D6FB50-35B6-4C81-B91C-3930B0D95386")]
public interface Reference

[GuidAttribute(L"35D6FB50-35B6-4C81-B91C-3930B0D95386")]
public interface class Reference

[<GuidAttribute("35D6FB50-35B6-4C81-B91C-3930B0D95386")>]
type Reference =  interface end

public interface Reference

O tipo Reference expõe os membros a seguir.

Propriedades

	Nome	Descrição
	BuildNumber	Obtém o número de compilação de referência.Somente leitura.
	Collection	Obtém a coleção que contém o objeto que da suporte a esta propriedade ou contido nesta construção de código.
	ContainingProject	Obtém o projeto que o item selecionado é uma parte.Somente leitura.
	CopyLocal	Determina se a referência será copiada no caminho local bin.
	Culture	Obtém a cadeia de caracteres de cultura de uma referência.Somente leitura.
	Description	Obtém uma descrição de texto de referência.Somente leitura.
	DTE	Obtém o objeto de nível superior de extensibilidade.
	Extender	Obtém o objeto solicitado do extensor está disponível para este objeto.
	ExtenderCATID	Obtém a ID da categoria de CATID taxa de proporção () para o objeto.
	ExtenderNames	Obtém uma lista de prolongamentos disponíveis para o objeto.
	Identity	Obtém o identificador exclusivo da referência.Somente leitura.
	MajorVersion	Obtém o número de versão principal da referência.Somente leitura.
	MinorVersion	Obtém o número da versão secundária da referência.Somente leitura.
	Name	Obtém o nome do objeto.Somente leitura.
	Path	Obtém o caminho para o arquivo de referência.Somente leitura.
	PublicKeyToken	Obtém o token de chave pública do assembly referenciado.
	RevisionNumber	Obtém o número de revisão de referência.Somente leitura.
	SourceProject	Obtém um objeto de Project se a referência é um projeto.Caso contrário, retorna Nothing (uma referência de nulluma referência nula (Nothing no Visual Basic) ).Somente leitura.
	StrongName	Obtém se a referência será inscrita com um par de chaves pública/privada.Somente leitura.
	Type	Obtém um valor de prjReferenceType que indica se a referência é um assembly ou um componente COM.Somente leitura.
	Version	Obtém a versão de referência selecionada.

Superior

Métodos

	Nome	Descrição
	Remove	Obtém a referência de objeto de References que o contém.

Superior

Comentários

os objetos deReference estão contidos na coleção de References do objeto de VSProject . Há dois tipos de objetos de Reference : assemblies (que incluem projetos do Visual Studio) e objetos COM. Quando uma referência é outro projeto, essa é chamada uma referência de projeto para o projeto e ainda considerada uma referência de assembly.

Exemplos

O exemplo a seguir cria um novo projeto de um modelo, adiciona duas referências, e exibe seus tipos.

'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

O exemplo a seguir cria um relatório sucinto propriedades de referência.

' 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

Consulte também

Referência

Namespace VSLangProj

Compartilhar via