Interfaccia Reference

Articolo
08/11/2011

Rappresenta un riferimento nel progetto. L'inserimento di un riferimento in un progetto consente di utilizzare qualsiasi membro pubblico contenuto nel riferimento stesso. I progetti possono includere riferimenti ad altri progetti .NET, ad assembly .NET e a oggetti COM.

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

Sintassi

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

Il tipo Reference espone i seguenti membri.

Proprietà

	Nome	Descrizione
	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.
	ContainingProject	Ottiene il progetto di cui fa parte l’elemento selezionato.Sola lettura.
	CopyLocal	Determina se il riferimento è copiato nella cartella \bin locale.
	Culture	Ottiene la stringa delle impostazioni cultura di un riferimento.Sola lettura.
	Description	Ottiene una descrizione del riferimento.Sola lettura.
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	Extender	Ottiene l'oggetto Extender richiesto, se disponibile per l'oggetto.
	ExtenderCATID	Ottiene l'ID della categoria (CATID) dell'oggetto Extender.
	ExtenderNames	Ottiene un elenco degli oggetti Extender disponibili per l'oggetto.
	Identity	Ottiene l'identificatore univoco del riferimento.Sola lettura.
	MajorVersion	Ottiene il numero di versione principale del riferimento.Sola lettura.
	MinorVersion	Ottiene il numero di versione secondario del riferimento.Sola lettura.
	Name	Ottiene il nome dell'oggetto.Sola lettura.
	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.
	RevisionNumber	Ottiene il numero di revisione del 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.
	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.
	Version	Ottiene la versione del riferimento selezionato.

In alto

Metodi

	Nome	Descrizione
	Remove	Ottiene il riferimento dall'oggetto References che lo contiene.

In alto

Note

Gli oggetti Reference sono contenuti nell'insieme della proprietà References dell'oggetto VSProject. Esistono due tipi di oggetti Reference: gli oggetti assembly, tra cui sono compresi i progetti di Visual Studio, e gli oggetti COM. Quando un riferimento è rappresentato da un progetto diverso, viene chiamato riferimento da progetto a progetto e viene ancora considerato un riferimento all'assembly.

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 VSLangProj

Condividi tramite