Procedura: aggiungere o rimuovere riferimenti in Visual Studio

  • Articolo

Per utilizzare un componente nell'applicazione è necessario prima aggiungere un riferimento a esso. Visual Studio fornisce cinque opzioni nella finestra di dialogo Aggiungi riferimento:

  • .NET elenca tutti i componenti .NET Framework a cui è possibile fare riferimento.

  • COM elenca tutti i componenti COM a cui è possibile fare riferimento.

  • Progetti elenca tutti i componenti riutilizzabili creati da progetti locali.

  • Sfoglia consente di selezionare un componente nel file system.

  • Recente contiene l'elenco dei componenti aggiunti di recente ai progetti nel computer.

Il numero di schede disponibili nella parte superiore della finestra di dialogo Aggiungi riferimento può variare a seconda del tipo di progetto aperto e delle risorse utilizzate. I progetti nativi C++ contengono solo una scheda Progetti.

Alcuni componenti nell'elenco potrebbero non essere visualizzati, a seconda della versione di .NET Framework del progetto. Ciò può verificarsi nelle seguenti condizioni:

  • Un componente che utilizza una versione recente di .NET Framework è incompatibile con un progetto destinato a una versione di .NET Framework precedente.

    Per informazioni sulla modifica della versione di .NET Framework di destinazione per un progetto, vedere Procedura: scelta di una versione o profilo di .NET Framework specifico.

  • Un componente che utilizza .NET Framework 4 è incompatibile con un progetto destinato a .NET Framework 4 Client Profile.

    Quando si crea una nuova applicazione, alcuni progetti sono destinati a .NET Framework 4 Client Profile per impostazione predefinita. Per ulteriori informazioni, vedere Profilo client .NET Framework.

Non è possibile aggiungere riferimenti dalla Global Assembly Cache poiché fa parte dell'ambiente di runtime.

Se si distribuisce o si copia un'applicazione che contiene un riferimento a un componente personalizzato registrato nella Global Assembly Cache, tale componente non verrà distribuito o copiato con l'applicazione, indipendentemente dall'impostazione di Copy Local. Per ulteriori informazioni, vedere Riferimenti dei progetti.

È possibile creare applicazioni che fanno riferimento a progetti o assembly destinati a una versione diversa di .NET Framework. Ad esempio, è possibile creare un'applicazione destinata a .NET Framework 4 Client Profile che fa riferimento a un assembly destinato a .NET Framework versione 2.0. Se si crea un progetto destinato a una versione precedente di .NET Framework, in tale progetto non è possibile impostare un riferimento a un progetto o un assembly destinato a .NET Framework 4 Client Profile o .NET Framework 4. Per ulteriori informazioni, vedere Scelta di una versione o profilo di .NET Framework specifico.

Evitare di aggiungere riferimenti a file agli output di altri progetti della stessa soluzione, poiché potrebbero verificarsi errori di compilazione. Utilizzare invece la scheda Progetti della finestra di dialogo Aggiungi riferimento per creare riferimenti da progetto a progetto. Tale procedura facilita lo sviluppo in team, consentendo una migliore gestione delle librerie di classi create nei progetti. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi ai riferimenti interrotti.

Nota

In Visual Studio 2010, viene creato un riferimento al file anziché un riferimento al progetto se la versione di destinazione di .NET Framework di un progetto è 4 e la versione di destinazione dell'altro progetto è 2, 3 o 3.5.

Se si desidera aggiungere un riferimento a una DLL COM registrata che contiene un manifesto interno, accertarsi prima di tutto di annullare la registrazione della DLL. In caso contrario, Visual Studio aggiungerà il riferimento all'assembly come un componente ActiveX e non come una DLL nativa.

È anche possibile aggiungere riferimenti Web tramite la finestra di dialogo Aggiungi riferimento Web. Per ulteriori informazioni, vedere Procedura: aggiungere e rimuovere riferimenti Web.

Quando si aggiunge manualmente un riferimento a qualsiasi spazio dei nomi EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a o EnvDTE100), impostare la proprietà Incorpora tipi di interoperabilità del riferimento su False nella finestra Proprietà. Se la proprietà viene impostata su True, possono verificarsi problemi di compilazione in quanto alcune proprietà EnvDTE non sono incorporabili.

Nota

Tutti i progetti contengono un riferimento implicito a mscorlib. I progetti di Visual Basic contengono un riferimento implicito a Microsoft.VisualBasic.

In Visual Studio 2010, tutti i progetti contengono un riferimento implicito a System.Core, anche se System.Core è rimosso dall'elenco di riferimenti.

Per visualizzare un assembly nella finestra di dialogo Aggiungi riferimento

  • Spostare o copiare l'assembly in una o più delle seguenti posizioni:

    • La directory del progetto corrente. (È possibile trovare questi assembly utilizzando la scheda Sfoglia.)

    • Altre directory di progetto nella stessa soluzione. (È possibile trovare questi assembly utilizzando la scheda Progetti.)

    oppure

  • Impostare una chiave del Registro di sistema che specifica il percorso degli assembly da visualizzare:

    Per un sistema operativo a 32 bit, aggiungere una delle seguenti chiavi del Registro di sistema.

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersioneMinima\AssemblyFoldersEx\MyAssemblies]@="PercorsoAssembly"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersioneMinima\AssemblyFoldersEx\MyAssemblies]@="PercorsoAssembly"

    Per un sistema operativo a 64 bit, aggiungere una delle seguenti chiavi del Registro di sistema in un hive del Registro di sistema a 32 bit.

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersioneMinima\AssemblyFoldersEx\MyAssemblies]@="PercorsoAssembly"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersioneMinima\AssemblyFoldersEx\MyAssemblies]@="PercorsoAssembly"

    VersioneMinima è la versione di .NET Framework minore applicabile. Se VersioneMinima è la 3.0, le cartelle specificate in AssemblyFoldersEx si applicano ai progetti destinati a .NET Framework 3.0 e versioni successive.

    PercorsoAssembly è la directory degli assembly che si desidera visualizzare nella finestra di dialogo Aggiungi riferimento, ad esempio C:\MyAssemblies\.

    Se la chiave del Registro di sistema viene creata nel nodo HKEY_LOCAL_MACHINE, tutti gli utenti possono visualizzare gli assembly nel percorso specificato nella finestra di dialogo Aggiungi riferimento. Se la chiave del Registro di sistema viene creata nel nodo HKEY_CURRENT_USER, ha effetto solo sull'impostazione dell'utente corrente.

    Aprire nuovamente la finestra di dialogo Aggiungi riferimento. Gli assembly dovrebbero essere visibili nella scheda .NET. In caso contrario, accertarsi che gli assembly si trovino nella directory PercorsoAssembly specificata, quindi riavviare Visual Studio e riprovare.

Per aggiungere un riferimento in Visual Basic

  1. In Esplora soluzioni, fare doppio clic sul nodo Progetto del progetto.

  2. Fare clic sulla scheda Riferimenti in Progettazione progetti.

  3. Fare clic sul pulsante Aggiungi per visualizzare la finestra di dialogo Aggiungi riferimento.

  4. Nella finestra di dialogo Aggiungi riferimento scegliere la scheda relativa al tipo di componente a cui fare riferimento.

  5. Selezionare il componente a cui si desidera fare riferimento e quindi scegliere OK.

    SuggerimentoSuggerimento

    È possibile selezionare più componenti tenendo premuto il tasto CTRL, purché tutti i componenti si trovino nella stessa scheda.

Per aggiungere un riferimento in Visual C#

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Aggiungi riferimento.

  2. Nella finestra di dialogo Aggiungi riferimento scegliere la scheda relativa al tipo di componente a cui fare riferimento.

  3. Selezionare il componente a cui si desidera fare riferimento e quindi scegliere OK.

    SuggerimentoSuggerimento

    È possibile selezionare più componenti tenendo premuto il tasto CTRL, purché tutti i componenti si trovino nella stessa scheda.

Per rimuovere un riferimento in Visual Basic

  1. In Esplora soluzioni fare doppio clic sul nodo Progetto del progetto.

  2. Fare clic sulla scheda Riferimenti in Progettazione progetti.

  3. Nell'elenco Riferimenti scegliere il riferimento che si desidera rimuovere.

  4. Fare clic sul pulsante Rimuovi.

    SuggerimentoSuggerimento

    È anche possibile verificare la presenza di riferimenti inutilizzati nel progetto e rimuoverli tutti contemporaneamente. Per ulteriori informazioni, vedere Procedura: rimuovere riferimenti non utilizzati (Visual Basic).

Per rimuovere un riferimento in Visual C#

  1. In Esplora soluzioni aprire il nodo Riferimenti all'interno del nodo del progetto.

  2. Fare clic con il pulsante destro del mouse su un riferimento e scegliere Rimuovi.

Vedere anche

Attività

Risoluzione dei problemi relativi ai riferimenti interrotti

Procedura: aggiungere o rimuovere spazi dei nomi importati (Visual Basic)

Procedura: rimuovere riferimenti non utilizzati (Visual Basic)

Procedura: impostare la proprietà Copia localmente di un riferimento

Procedura: aggiungere elementi di progetto nuovi

Procedura: aggiungere e rimuovere riferimenti Web

Procedura: impostare il percorso di riferimento (C#)

Riferimenti

Pagina Applicazione, Progettazione progetti (C#)

Finestra di dialogo Impostazioni del compilatore avanzate (Visual Basic)

Concetti

Riferimenti dei progetti

Riferimenti Web in Visual Studio

Cenni preliminari sul multitargeting di Visual Studio

Risoluzione dei problemi relativi agli errori di impostazione di .NET Framework come destinazione

Altre risorse

Gestione dei riferimenti

Riferimenti a spazi dei nomi e componenti

Scelta di una versione o profilo di .NET Framework specifico