Interfaccia Reference2

Articolo
08/11/2011

Estende l'interfaccia Reference dello spazio dei nomi VSLangProj.

Spazio dei nomi: VSLangProj2
Assembly: VSLangProj2 (in VSLangProj2.dll)

Sintassi

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

Il tipo Reference2 espone i seguenti membri.

Proprietà

	Nome	Descrizione
	BuildNumber	Recupera il numero di build del riferimento.Sola lettura. (Ereditato da Reference)
	BuildNumber	Recupera il numero di build del riferimento.Sola lettura.
	Collection	Ottiene l'insieme che contiene l'oggetto che supporta la proprietà o che è contenuto nel costrutto di codice. (Ereditato da Reference)
	Collection	Ottiene un insieme di oggetti References.
	ContainingProject	Ottiene il progetto di cui fa parte l’elemento selezionato.Sola lettura. (Ereditato da Reference)
	ContainingProject	Ottiene l'oggetto Project che contiene il riferimento.
	CopyLocal	Determina se il riferimento è copiato nella cartella \bin locale. (Ereditato da Reference)
	CopyLocal	Determina se il riferimento è copiato nella cartella \bin locale.
	Culture	Ottiene la stringa delle impostazioni cultura di un riferimento.Sola lettura. (Ereditato da Reference)
	Culture	Ottiene la stringa delle impostazioni cultura di un riferimento.Sola lettura.
	Description	Ottiene una descrizione del riferimento.Sola lettura. (Ereditato da Reference)
	Description	Ottiene una descrizione del riferimento.Sola lettura.
	DTE	Ottiene l'oggetto estensibilità di primo livello. (Ereditato da Reference)
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	Extender[String]	Ottiene l'oggetto Extender richiesto, se disponibile per l'oggetto. (Ereditato da Reference)
	Extender[String]	Restituisce l'oggetto Extender richiesto, se disponibile per l'oggetto.
	ExtenderCATID	Ottiene l'ID della categoria (CATID) dell'oggetto Extender. (Ereditato da Reference)
	ExtenderCATID	Ottiene l'ID della categoria (CATID) dell'oggetto Extender.
	ExtenderNames	Ottiene un elenco degli oggetti Extender disponibili per l'oggetto. (Ereditato da Reference)
	ExtenderNames	Ottiene un elenco degli oggetti Extender disponibili per l'oggetto.
	Identity	Ottiene l'identificatore univoco del riferimento.Sola lettura. (Ereditato da Reference)
	Identity	Ottiene l'identificatore univoco del riferimento.Sola lettura.
	MajorVersion	Ottiene il numero di versione principale del riferimento.Sola lettura. (Ereditato da Reference)
	MajorVersion	Ottiene il numero di versione principale del riferimento.Sola lettura.
	MinorVersion	Ottiene il numero di versione secondario del riferimento.Sola lettura. (Ereditato da Reference)
	MinorVersion	Ottiene il numero di versione secondario del riferimento.Sola lettura.
	Name	Ottiene il nome dell'oggetto.Sola lettura. (Ereditato da Reference)
	Name	Ottiene il nome dell'oggetto.Sola lettura.
	Path	Ottiene il percorso al file del riferimento.Sola lettura. (Ereditato da Reference)
	Path	Ottiene il percorso al file del riferimento.Sola lettura.
	PublicKeyToken	Ottiene il token della chiave pubblica per l'assembly a cui viene fatto riferimento. (Ereditato da Reference)
	PublicKeyToken	Ottiene il token della chiave pubblica per l'assembly a cui viene fatto riferimento.
	RevisionNumber	Ottiene il numero di revisione del riferimento.Sola lettura. (Ereditato da Reference)
	RevisionNumber	Ottiene il numero di revisione del riferimento.Sola lettura.
	RuntimeVersion	Ottiene e imposta la versione del runtime rispetto a cui è stato generato il riferimento.Sola lettura.
	SourceProject	Ottiene un oggetto Project se il riferimento è un progetto.In caso contrario, restituisce Nothing (un riferimento nullriferimento null (Nothing in Visual Basic)).Sola lettura. (Ereditato da Reference)
	SourceProject	Ottiene un oggetto Project se il riferimento è un progetto.In caso contrario, restituisce Nothing (un riferimento nullriferimento null (Nothing in Visual Basic)).Sola lettura.
	StrongName	Ottiene l'indicazione che stabilisce se il riferimento è firmato con una coppia di chiavi pubblica/privata.Sola lettura. (Ereditato da Reference)
	StrongName	Ottiene l'indicazione che stabilisce se il riferimento è firmato con una coppia di chiavi pubblica/privata.Sola lettura.
	Type	Ottiene un valore prjReferenceType che indica se un riferimento è un assembly o un componente COM.Sola lettura. (Ereditato da Reference)
	Type	Ottiene un valore prjReferenceType che indica se un riferimento è un assembly o un componente COM.Sola lettura.
	Version	Ottiene la versione del riferimento selezionato. (Ereditato da Reference)
	Version	Ottiene la versione del riferimento selezionato.

In alto

Metodi

	Nome	Descrizione
	Remove()	Ottiene il riferimento dall'oggetto References che lo contiene. (Ereditato da Reference)
	Remove()	Rimuove il riferimento dall'oggetto References che lo contiene.

In alto

Note

Gli oggetti Reference restituiti dall'insieme References dell'oggetto VSProject supportano sia l'interfaccia Reference che l'interfaccia Reference2. Eseguire il cast dell'oggetto Reference2 per accedere ai membri di Reference2.

Reference2 definisce tutti i membri di Reference trovati nello spazio dei nomi VSLangProj, oltre a:

RuntimeVersion

Esempi

L'esempio seguente crea un nuovo progetto da un modello, aggiunge due riferimenti e ne visualizza i tipi.

'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'esempio seguente crea un breve rapporto delle proprietà di un riferimento.

' 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

Vedere anche

Riferimenti

Spazio dei nomi VSLangProj2

Condividi tramite