Reference2-Schnittstelle

Erweitert die Reference-Schnittstelle des VSLangProj-Namespaces.

Namespace:  VSLangProj2
Assembly:  VSLangProj2 (in VSLangProj2.dll)

Syntax

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

Der Reference2-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	BuildNumber	Ruft die Buildnummer des Verweises ab.Schreibgeschützt.
	Collection	Ruft eine Auflistung von References ab.
	ContainingProject	Ruft das Project-Objekt ab, das den Verweis enthält.
	CopyLocal	Legt fest, ob der Verweis in das lokale Bin-Verzeichnis kopiert wird.
	Culture	Ruft die Culture-Zeichenfolge eines Verweises ab.Schreibgeschützt.
	Description	Ruft eine Textbeschreibung des Verweises ab.Schreibgeschützt.
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	Extender	Gibt das angeforderte Extenderobjekt zurück, falls es für dieses Objekt verfügbar ist.
	ExtenderCATID	Ruft die ID der Extenderkategorie (CATID) für das Objekt ab.
	ExtenderNames	Ruft eine Liste der für das Objekt verfügbaren Extender ab.
	Identity	Ruft den eindeutigen Bezeichner des Verweises ab.Schreibgeschützt.
	MajorVersion	Ruft die Hauptversionsnummer des Verweises ab.Schreibgeschützt.
	MinorVersion	Ruft die Nebenversionsnummer des Verweises ab.Schreibgeschützt.
	Name	Ruft den Namen des Objekts ab.Schreibgeschützt.
	Path	Ruft den Pfad zur Verweisdatei ab.Schreibgeschützt.
	PublicKeyToken	Ruft das öffentliche Schlüsseltoken der Assembly ab, auf die verwiesen wird.
	RevisionNumber	Ruft die Revisionsnummer des Verweises ab.Schreibgeschützt.
	RuntimeVersion	Ruft die Version der Laufzeit ab, gegen die der Verweis erstellt wurde, und legt diese fest.Schreibgeschützt.
	SourceProject	Ruft ein Project-Objekt ab, wenn es sich bei dem Verweis um ein Projekt handelt.Andernfalls wird Nothing (ein nullein Nullverweis (Nothing in Visual Basic)-Verweis) zurückgegeben.Schreibgeschützt.
	StrongName	Stellt fest, ob der Verweis mit einem Schlüsselpaar aus einem öffentlichen und einem privaten Schlüssel signiert ist.Schreibgeschützt.
	Type	Ruft einen prjReferenceType-Wert ab, der angibt, ob der Verweis eine Assembly oder eine COM-Komponente ist.Schreibgeschützt.
	Version	Ruft die Version des ausgewählten Verweises ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Remove	Entfernt den Verweis aus dem References-Objekt, das den Verweis enthält.

Zum Seitenanfang

Hinweise

Die von der References-Auflistung des VSProject-Objekts zurückgegebenen Reference-Objekte unterstützen sowohl die Reference-Schnittstelle als auch die Reference2-Schnittstelle. Wandeln Sie das Objekt in Reference2 um, um auf die Reference2-Member zuzugreifen.

Von Reference2 werden alle im VSLangProj-Namespace gefundenen Reference-Member und zusätzlich die folgende Eigenschaft definiert:

• RuntimeVersion

Beispiele

Im folgenden Beispiel wird ein neues Projekt aus einer Vorlage erstellt. Außerdem werden zwei Verweise hinzugefügt, deren Typ angezeigt wird.

'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

Im folgenden Beispiel wird ein kurzer Bericht über die Eigenschaften eines Verweises erstellt.

' 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

Siehe auch

Referenz

VSLangProj2-Namespace