Reference – rozhraní

Článek
08/11/2011

Představuje jeden odkaz v projektu. V projektu včetně odkazu umožňuje používat žádné veřejné členy obsažených v odkazu. Projekty mohou zahrnovat odkazy na jiné.NET projektů.ČISTÉ sestavení a objekty COM.

Obor názvů: VSLangProj
Sestavení: VSLangProj (v VSLangProj.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	BuildNumber	Referenční číslo sestavení získá.Jen pro čtení
	Collection	Získá kolekci obsahující objekt podporující tuto vlastnost nebo obsažených v této konstrukce kódu.
	ContainingProject	Získá projekt, který je součástí vybrané položky.Jen pro čtení
	CopyLocal	Určuje, zda odkaz je zkopírován do přihrádky místní cesta.
	Culture	Načte řetězec označující kulturu odkaz.Jen pro čtení
	Description	Načte text popisu odkazu.Jen pro čtení
	DTE	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	Extender	Pokud je k dispozici pro tento objekt získá požadovaný objekt zařízení Extender.
	ExtenderCATID	Kategorie zařízení Extender ID (CATID) získá pro objekt.
	ExtenderNames	Získá seznam dostupných zařízení Extender pro objekt.
	Identity	Získá jedinečný identifikátor odkaz.Jen pro čtení
	MajorVersion	Získá hlavní číslo verze odkazu.Jen pro čtení
	MinorVersion	Získá číslo podverze odkazu.Jen pro čtení
	Name	Získá název objektu.Jen pro čtení
	Path	Cesta k souboru referenční získá.Jen pro čtení
	PublicKeyToken	Získá token veřejného klíče pro odkazované sestavení.
	RevisionNumber	Referenční číslo revize získá.Jen pro čtení
	SourceProject	Získává Project objektu, pokud je odkaz na projekt.V opačném případě vrátí hodnotu Nothing ( nullodkaz Null (Nothing v jazyce Visual Basic) odkaz).Jen pro čtení
	StrongName	Získá zda odkaz je podepsán dvojici veřejného a soukromého klíče.Jen pro čtení
	Type	Získává prjReferenceType hodnotu označující, zda je odkaz na sestavení nebo součást COM.Jen pro čtení
	Version	Načte verzi vybraný odkaz.

Na začátek

Metody

	Název	Popis
	Remove	Získá odkaz z References objekt, který obsahuje jej.

Na začátek

Poznámky

Referenceobjekty jsou obsaženy v VSProject objektu References kolekce. Existují dva typy Reference objekty: sestavení (projekty aplikace Visual Studio včetně) a objekty COM. Jiný projekt po odkaz to se nazývá projekt do projektu odkaz a stále považuje za odkaz na sestavení.

Příklady

Následující příklad vytvoří nový projekt ze šablony, přidá dva odkazy a zobrazí jejich 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

Následující příklad vytvoří krátké zprávy odkaz vlastnosti.

' 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

Viz také

Odkaz

VSLangProj – obor názvů

Sdílet prostřednictvím