Reference-Schnittstelle
Stellt einen Verweis im Projekt dar. Wenn Sie einen Verweis in ein Projekt einfügen, können Sie alle öffentlichen Member verwenden, die im Verweis enthalten sind. Projekte können Verweise auf andere .NET-Projekte, .NET-Assemblys und COM-Objekte umfassen.
Namespace: VSLangProj
Assembly: VSLangProj (in VSLangProj.dll)
Syntax
'Declaration
<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
Der Reference-Typ macht die folgenden Member verfügbar.
Eigenschaften
Name | Beschreibung | |
---|---|---|
BuildNumber | Ruft die Buildnummer des Verweises ab.Schreibgeschützt. | |
Collection | Ruft die Auflistung mit dem Objekt ab, das diese Eigenschaft unterstützt oder das in diesem Codekonstrukt enthalten ist. | |
ContainingProject | Ruft das Projekt ab, in dem das ausgewählte Element enthalten ist.Schreibgeschützt. | |
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 | Ruft das angeforderte Extenderobjekt ab, 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. | |
SourceProject | Ruft ein Project-Objekt ab, wenn es sich bei dem Verweis um ein Projekt handelt.Andernfalls wird Nothing (ein nullNULL-Verweis (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 | Ruft den Verweis aus dem References-Objekt ab, in dem der Verweis enthalten ist. |
Zum Seitenanfang
Hinweise
Reference-Objekte sind in der References-Auflistung des VSProject-Objekts enthalten. Es gibt zwei Arten von Reference-Objekten: Assemblys (einschließlich Visual Studio-Projekten) und COM-Objekte. Wenn es sich bei einem Verweis um ein anderes Projekt handelt, wird dieser Verweis als Projekt-zu-Projekt-Verweis bezeichnet und immer noch als Assemblyverweis betrachtet.
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