Reference2, interface

Article
05/16/2015

Étend l'interface Reference de l'espace de noms VSLangProj.

Espace de noms : VSLangProj2
Assembly : VSLangProj2 (dans VSLangProj2.dll)

Syntaxe

'Déclaration
<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

Le type Reference2 expose les membres suivants.

Propriétés

	Nom	Description
	BuildNumber	Obtient le numéro de build de la référence.En lecture seule.
	Collection	Obtient une collection de References.
	ContainingProject	Obtient le Project qui contient la référence.
	CopyLocal	Détermine si la référence est copiée dans le chemin bin local.
	Culture	Obtient la chaîne Culture d'une référence.En lecture seule.
	Description	Obtient un texte de description de la référence.En lecture seule.
	DTE	Obtient l'objet d'extensibilité de niveau supérieur.
	Extender	Retourne l'objet Extender demandé s'il est disponible pour cet objet.
	ExtenderCATID	Obtient l'identificateur de catégorie (CATID) d'extendeur de l'objet.
	ExtenderNames	Obtient une liste d'extendeurs disponibles pour l'objet.
	Identity	Obtient l'identificateur unique de la référence.En lecture seule.
	MajorVersion	Retourne le numéro de version majeure de la référence.En lecture seule.
	MinorVersion	Obtient le numéro de version mineure de la référence.En lecture seule.
	Name	Obtient le nom de l'objet.En lecture seule.
	Path	Obtient le chemin d'accès au fichier de référence.En lecture seule.
	PublicKeyToken	Obtient le jeton de clé publique de l'assembly référencé.
	RevisionNumber	Obtient le numéro de révision de la référence.En lecture seule.
	RuntimeVersion	Obtient et définit la version du runtime par rapport à laquelle la référence a été générée.En lecture seule.
	SourceProject	Obtient un objet Project si la référence est un projet.Sinon, retourne Nothing (référence nullune référence null (Nothing en Visual Basic)).En lecture seule.
	StrongName	Obtient une valeur indiquant si la référence est signée à l'aide d'une paire de clés publique/privée.En lecture seule.
	Type	Obtient une valeur prjReferenceType indiquant si une référence est un assembly ou un composant COM.En lecture seule.
	Version	Obtient la version de la référence sélectionnée.

Début

Méthodes

	Nom	Description
	Remove	Supprime la référence de l'objet References qui la contient.

Début

Notes

Les objets Reference retournés par la collection References de l'objet VSProject prend en charge à la fois l'interface Reference et l'interface Reference2. Effectuez un cast de l'objet en Reference2 afin d'accéder aux membres Reference2.

Reference2 définit tous les membres Reference trouvés dans l'espace de noms VSLangProj, plus :

RuntimeVersion

Exemples

L'exemple suivant crée un nouveau projet à partir d'un modèle, ajoute deux références et affiche leurs types.

'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

L'exemple suivant crée un court rapport des propriétés d'une référence.

' 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

Voir aussi

Référence

VSLangProj2, espace de noms

Partager via