Reference2 - интерфейс

Расширяет интерфейс Reference пространства имен VSLangProj.

Пространство имен:  VSLangProj2
Сборка:  VSLangProj2 (в VSLangProj2.dll)

Синтаксис

'Декларация
<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

Тип Reference2 предоставляет следующие члены.

Свойства

	Имя	Описание
	BuildNumber	Получает номер построения ссылки.Только для чтения. (Унаследовано от Reference.)
	BuildNumber	Получает номер построения ссылки.Только для чтения.
	Collection	Возвращает коллекцию, содержащую объект, который поддерживает это свойство или содержится в этой конструкции кода. (Унаследовано от Reference.)
	Collection	Получает коллекцию объектов References.
	ContainingProject	Получает проект, частью которого является выбранный элемент.Только для чтения. (Унаследовано от Reference.)
	ContainingProject	Получает объект Project, содержащий ссылку.
	CopyLocal	Определяет, будет ли ссылка копироваться в локальную папку Bin. (Унаследовано от Reference.)
	CopyLocal	Определяет, будет ли ссылка копироваться в локальную папку Bin.
	Culture	Получает строку языка и региональных параметров ссылки.Только для чтения. (Унаследовано от Reference.)
	Culture	Получает строку языка и региональных параметров ссылки.Только для чтения.
	Description	Получает текстовое описание ссылки.Только для чтения. (Унаследовано от Reference.)
	Description	Получает текстовое описание ссылки.Только для чтения.
	DTE	Возвращает объект расширения верхнего уровня. (Унаследовано от Reference.)
	DTE	Возвращает объект расширения верхнего уровня.
	Extender[String]	Возвращает запрашиваемый объект расширителя, если он доступен для данного объекта. (Унаследовано от Reference.)
	Extender[String]	Возвращает запрашиваемый объект-расширитель, если он доступен для данного объекта.
	ExtenderCATID	Возвращает для объекта ИДЕНТИФИКАТОР категории расширителя (CATID). (Унаследовано от Reference.)
	ExtenderCATID	Возвращает для объекта ИДЕНТИФИКАТОР категории расширителя (CATID).
	ExtenderNames	Возвращает перечень доступных расширителей объекта. (Унаследовано от Reference.)
	ExtenderNames	Возвращает перечень доступных расширителей объекта.
	Identity	Возвращает уникальный идентификатор ссылки.Только для чтения. (Унаследовано от Reference.)
	Identity	Возвращает уникальный идентификатор ссылки.Только для чтения.
	MajorVersion	Получает основной номер версии ссылки.Только для чтения. (Унаследовано от Reference.)
	MajorVersion	Получает основной номер версии ссылки.Только для чтения.
	MinorVersion	Получает дополнительный номер версии ссылки.Только для чтения. (Унаследовано от Reference.)
	MinorVersion	Получает дополнительный номер версии ссылки.Только для чтения.
	Name	Возвращает имя объекта.Только для чтения. (Унаследовано от Reference.)
	Name	Возвращает имя объекта.Только для чтения.
	Path	Получает путь к файлу ссылки.Только для чтения. (Унаследовано от Reference.)
	Path	Получает путь к файлу ссылки.Только для чтения.
	PublicKeyToken	Получает токен открытого ключа для сборки в ссылке. (Унаследовано от Reference.)
	PublicKeyToken	Получает токен открытого ключа для сборки в ссылке.
	RevisionNumber	Получает номер редакции ссылки.Только для чтения. (Унаследовано от Reference.)
	RevisionNumber	Получает номер редакции ссылки.Только для чтения.
	RuntimeVersion	Получает или задает версию среды выполнения, в которой построена ссылка.Только для чтения.
	SourceProject	Получает объект Project, если ссылка является проектом.В противном случае возвращается Nothing (ссылка nullпустая ссылка (Nothing в Visual Basic)).Только для чтения. (Унаследовано от Reference.)
	SourceProject	Получает объект Project, если ссылка является проектом.В противном случае возвращается Nothing (ссылка nullпустая ссылка (Nothing в Visual Basic)).Только для чтения.
	StrongName	Получает значение, указывающее, подписана ли ссылка парой открытого и закрытого ключа.Только для чтения. (Унаследовано от Reference.)
	StrongName	Получает значение, указывающее, подписана ли ссылка парой открытого и закрытого ключа.Только для чтения.
	Type	Получает значение prjReferenceType, указывающее, является ли ссылка сборкой или компонентом COM.Только для чтения. (Унаследовано от Reference.)
	Type	Получает значение prjReferenceType, указывающее, является ли ссылка сборкой или компонентом COM.Только для чтения.
	Version	Получает версию выбранной ссылки. (Унаследовано от Reference.)
	Version	Получает версию выбранной ссылки.

В начало страницы

Методы

	Имя	Описание
	Remove()	Получает ссылку из объекта References, в котором она содержится. (Унаследовано от Reference.)
	Remove()	Удаляет ссылку из объекта References, в котором она содержится.

В начало страницы

Заметки

Объекты Reference, возвращаемые коллекцией References объекта VSProject, поддерживают как интерфейс Reference, так и интерфейс Reference2. Приведите объект к Reference2 для доступа к элементам Reference2.

Reference2 задает все элементы Reference, найденные в пространстве имен VSLangProj, плюс:

• RuntimeVersion

Примеры

В следующем примере из шаблона создается новый проект, добавляются две ссылки, а также отображаются их типы.

'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

В следующем примере создается краткий отчет о свойствах ссылки.

' 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

См. также

Ссылки

VSLangProj2 - пространство имен