Interfejs Reference

Reprezentuje jedno odwołanie w projekcie.W projekcie w tym odwołanie umożliwia Użyj któregokolwiek z członków publicznych wchodzących w skład odwołania.Projekty mogą zawierać odwołania do innych projektów .NET, zestawów .NET i obiekty COM.

Przestrzeń nazw:  VSLangProj
Zestaw:  VSLangProj (w VSLangProj.dll)

Składnia

'Deklaracja
<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

Typ Reference uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	BuildNumber	Pobiera numer kompilacji odwołania.Tylko do odczytu.
	Collection	Pobiera kolekcja zawierające obiekt obsługuje tej właściwości lub zawarte w tej konstrukcji kodu.
	ContainingProject	Pobiera wybrany element jest częścią projektu.Tylko do odczytu.
	CopyLocal	Określa, czy odwołanie jest kopiowany do ścieżki lokalnej pojemnika.
	Culture	Pobiera ciąg kultury odniesienia.Tylko do odczytu.
	Description	Pobiera tekst opisu odwołania.Tylko do odczytu.
	DTE	Pobiera obiekt rozszerzeń najwyższego poziomu.
	Extender	Pobiera żądany obiekt urządzenia Extender, jeśli jest on dostępny dla tego obiektu.
	ExtenderCATID	Pobiera kategorii urządzenia Extender ID (Identyfikator CATID) dla obiektu.
	ExtenderNames	Pobiera listę dostępnych urządzeń Extender dla obiektu.
	Identity	Pobiera identyfikator unikatowy odwołania.Tylko do odczytu.
	MajorVersion	Pobiera numer wersji głównej odwołania.Tylko do odczytu.
	MinorVersion	Pobiera numer wersji pomocniczej odwołania.Tylko do odczytu.
	Name	Pobiera nazwę obiektu.Tylko do odczytu.
	Path	Pobiera ścieżkę do pliku odwołania.Tylko do odczytu.
	PublicKeyToken	Pobiera tokenu klucza publicznego dla odwołania zestawu.
	RevisionNumber	Pobiera numer poprawki odwołania.Tylko do odczytu.
	SourceProject	Pobiera Project obiektu, jeśli odwołanie dotyczy projektu.W przeciwnym wypadku zwraca Nothing ( nullodwołanie o wartości null (Nothing w języku Visual Basic) odniesienia).Tylko do odczytu.
	StrongName	Pobiera się, czy odwołanie jest podpisany za pomocą pary kluczy publiczny/prywatny.Tylko do odczytu.
	Type	Pobiera prjReferenceType wartość wskazującą, czy odwołanie jest zestaw lub składnik modelu COM.Tylko do odczytu.
	Version	Pobiera wersję wybranego odwołania.

Początek

Metody

	Nazwa	Opis
	Remove	Pobiera odwołanie z References obiektu, który go zawiera.

Początek

Uwagi

Referenceobiekty są zawarte w VSProject obiektu References kolekcji.Istnieją dwa rodzaje Reference obiektów: zespoły (w tym projektów programu Visual Studio) i obiekty COM.Jeśli odwołanie jest inny projekt, nazywa się odwołanie projektu do projektu i jest nadal uważane za odwołania do zestawu.

Przykłady

Poniższy przykład tworzy nowy projekt z szablonu, dodaje dwa odniesienia i wyświetla ich typy.

'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

Poniższy przykład tworzy krótkie sprawozdanie właściwości odwołania.

' 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

Zobacz też

Informacje

Przestrzeń nazw VSLangProj