Procedura: aggiungere o rimuovere riferimenti mediante Gestione riferimenti

È possibile utilizzare la finestra di dialogo Gestione riferimenti per aggiungere e gestire i riferimenti ai componenti di, Microsoft, o un'altra società hanno compilato.Se si sviluppa un'applicazione di Windows Store, il progetto fa riferimento automaticamente tutto Windows 8 SDK e .NET Framework.Se si sviluppa un altro tipo di progetto, è necessario aggiungere questi riferimenti manualmente al progetto.

Nota di avvisoAttenzione

È possibile aggiungere riferimenti in altri tipi di progetti mediante la finestra di dialogo Aggiungi riferimento.Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere riferimenti utilizzando la finestra di dialogo Aggiungi riferimento.

Aggiunta e rimozione di un riferimento

Per aggiungere un riferimento a un progetto

  1. Sulla barra dei menu, scegliere File, Apri.

  2. Selezionare la soluzione o del progetto.

  3. In Esplora soluzioni, scegliere dal menu di scelta rapida del nodo riferimenti e quindi scegliere Aggiungi riferimento.

  4. Nella finestra di dialogo Gestione riferimenti, specificare i riferimenti per aggiungere quindi scegliere il pulsante OK.

Per rimuovere un riferimento, aprire il menu di scelta rapida e quindi scegliere Rimuovi.

Per aggiungere un riferimento in un progetto c++

  1. Sulla barra dei menu, scegliere File, Apri.

  2. Selezionare la soluzione o del progetto.

  3. In Esplora soluzioni, scegliere dal menu di scelta rapida del nodo di progetto e quindi scegliere Riferimenti.

  4. Nella finestra di dialogo Pagine delle proprietà, scegliere il pulsante Aggiungi nuovo riferimento.

  5. Nella finestra di dialogo Aggiungi riferimento, specificare i riferimenti per aggiungere quindi scegliere il pulsante OK.

Per rimuovere un riferimento, aprire il menu di scelta rapida e quindi scegliere Rimuovi.

Gestione riferimenti aperto ed elenca i riferimenti disponibili nel gruppo.Il tipo di progetto determina quale dei seguenti gruppi vengono visualizzati:

  • Assembly, con i sottogruppi di estensioni e del Framework.

  • Soluzione, con il sottogruppo di progetti.

  • Windows, con i sottogruppi di estensioni e di base.È possibile esplorare i riferimenti in Windows SDK o estensione SDK utilizzando Visualizzatore oggetti.

  • Visualizzazione, con il sottogruppo recente.

Scheda di assembly

La scheda Assembly elenca tutti gli assembly.NET Framework disponibili per fare riferimento.La scheda Assembly non vengono elencati alcuni assembly dalla Global Assembly Cache (GAC) poiché gli assembly nella global assembly cache fa parte dell'ambiente di runtime.Se si distribuisce o si copia un'applicazione che contiene un riferimento a un assembly registrato nella global assembly cache, non verrà distribuito o non copiato con l'applicazione, indipendentemente dall'impostazione copia localmente.Per ulteriori informazioni, vedere Riferimenti al progetto.

Quando si aggiunge manualmente un riferimento a qualsiasi spazio dei nomi EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a EnvDTE100, o), impostare la proprietà incorpora tipi di interoperabilità incorporando di riferimento su False nella Finestra Proprietà.Impostare questa proprietà per allineare può causare problemi di compilazione a causa di alcune proprietà EnvDTE non possono essere incorporate.

Tutti i progetti desktop contengono un riferimento implicito a mscorlib.i progettiVisual Basic contengono un riferimento implicito a Microsoft.VisualBasic.In Visual Studio 2012, tutti i progetti contengono un riferimento implicito a System.Core, anche se ha rimosso dall'elenco di riferimenti.

Se un tipo di progetto non fa assembly di supporto, la scheda non verrà visualizzata nella finestra di dialogo Gestione riferimenti.

La scheda di assembly è costituito dai due schede:

  1. Elenchi di Framework tutti gli assembly che costituiscono Framework di destinazione.

    • Gli assembly annunciati in Framework completo e vengono enumerati nell'elenco dei Framework quando il progetto è destinato a un profilo del Framework di destinazione.Gli assembly sono annunciati in grigio distinguerle gli assembly presenti nel profilo del framework di destinazione del progetto.Ad esempio, se un progetto ha il client.NET Framework 4, l'elenco di Framework vengono illustrati gli assembly annunciati da .NET Framework 4.Quando un utente aggiunge un assembly annunciato, l'utente riceve una notifica che, dopo la finestra di dialogo Gestione riferimenti viene chiusa, il progetto verrà reindirizzato a .NET Framework 4 e l'assembly annunciato verrà aggiunto.

    • I progetti per le applicazioni di Windows Store contengono riferimenti a tutti gli assembly in .NET per applicazioni Windows Store di destinazione per impostazione predefinita la creazione del progetto.Nei progetti gestiti, un nodo di sola lettura nella cartella riferimenti in Esplora soluzioni il riferimento all'intero Framework.Pertanto, la scheda di Framework nessuno enumererà gli assembly da Framework ma non viene visualizzato il messaggio seguente: "Tutti gli assembly.NET Framework sono già fatto riferimento.Utilizzare il Visualizzatore oggetti per esplorare i riferimenti in Framework." Per i progetti desktop, la scheda di Framework enumera gli assembly da Framework di destinazione e sarà necessario aggiungere i riferimenti dell'applicazione.

  2. Le estensioni sono elencati tutti gli assembly che i fornitori esterni di componenti e controlli sono compilati per estendere Framework di destinazione.Secondo lo scopo dell'applicazione utente, potrebbe essere necessario utilizzare questi assembly.

    • Le estensioni è compilata enumerano gli assembly che vengono registrati nei seguenti percorsi:

      32-bit machine:
      HKEY_CURRENT_USER\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      64-bit machine:
      HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      And older versions of the [Target Framework Identifier]
      

      Ad esempio, se un progetto è destinato a.NET Framework 4 in un computer a 32 bit, le estensioni enumereranno gli assembly inclusi in registrato \ Microsoft \ .NETFramework \ v4.0 \ AssemblyFoldersEx \, \ Microsoft \ .NETFramework \ v3.5 \ AssemblyFoldersEx \, \ Microsoft \ .NETFramework \ v3.0 \ AssemblyFoldersEx \ o \ Microsoft \ .NETFramework \ v2.0 \ AssemblyFoldersEx \.

COM tabulazione

COM sono inclusi elenca tutti i componenti COM disponibili per fare riferimento.Per aggiungere un riferimento a una DLL COM registrato che contiene un manifesto interno, annullare la registrazione della DLL prima.In caso contrario, Visual Studio aggiunge il riferimento al controllo ActiveX non come una DLL nativa.

Se un tipo di progetto non supporta COM, la scheda non verrà visualizzata nella finestra di dialogo Gestione riferimenti.

Scheda della soluzione

La scheda della soluzione sono elencati tutti i progetti compatibili nella soluzione corrente, progetti sottoscheda.

Un progetto può fare riferimento a un altro progetto destinato a una versione diversa di .NET Framework.Ad esempio, è possibile creare un progetto destinato a .NET Framework 4 ma che fa riferimento a un assembly compilato per .NET Framework 2.Tuttavia, il progetto .NET Framework 2 non può fare riferimento a un progetto .NET Framework 4.Per ulteriori informazioni, vedere Scelta di una versione o profilo di .NET Framework specifico.

Un progetto destinato a .NET Framework 4 è incompatibile con un progetto destinato a .NET Framework 4 Client Profile.

In Visual Studio 2012, un riferimento di file anziché un riferimento al progetto viene creato se un progetto è destinato a.NET Framework 4 e un altro progetto destinato a una versione precedente.

Un progetto destinato a .NET per applicazioni Windows Store impossibile aggiungere un riferimento di progetto a un progetto destinato a .NET Framework e viceversa.

Scheda finestre

Scheda finestre vengono elencati tutti gli SDK specifici delle piattaforme in esecuzione i sistemi operativi Windows.

È possibile generare un file di WinMD in Visual Studio in due modi:

  • Windows Store progetti gestiti di applicazione: i progetti di applicazione Windows Store possono restituire i binari di WinMD impostando le proprietà del progetto | Tipo di output = file di WinMD.Il nome file di WinMD deve essere lo spazio dei nomi del superset di tutti gli spazi dei nomi presenti in.Ad esempio, se un progetto è costituito dagli spazi dei nomi A.B e A.B.C, i nomi possibili per il WinMD viene sono A.winmd e A.B.winmd.Se un utente immette le proprietà del progetto | Nome proprietà o del progetto dell'assembly | Il valore dello spazio dei nomi che si selezioni dal set di spazi dei nomi nel progetto non è presente alcun spazio dei nomi del superset all'interno di un progetto, un avviso di compilazione verrà generato: "A.winmd" non è un nome di file valido di .winmd per l'assembly.Tutti i tipi contenuti in un file di metadati delle finestre devono esistere in un nello spazio dei nomi del nome file.I tipi che non esistono in un nello spazio dei nomi del nome file non potranno essere individuato in fase di esecuzione.In questo assembly, il più piccolo spazio dei nomi comune è "CSWSClassLibrary1".Un progetto desktop in Visual c o Visual Basic è possibile utilizzare solo WinMDs generato utilizzando Windows 8 SDK, noti come prima parte WinMDs e non può generare WinMDs.

  • Windows Store progetti nativi di applicazione: Un file di WinMD nativi è costituito da solo metadati.L'implementazione esistente in un file DLL separato.È possibile produrre i binari nativi scegliendo il modello di progetto di componenti di runtime di Windows nella finestra di dialogo Nuovo progetto o da a partire da un progetto vuoto e modificando le proprietà del progetto per generare un file di WinMD.Se il progetto è costituito da disgiunga gli spazi dei nomi, un errore di compilazione indicato dall'utente di combinare gli spazi dei nomi o di eseguire lo strumento di MSMerge.

La scheda di Windows è costituito da due sottocartelle schede.

Hh708954.collapse_all(it-it,VS.110).gifSottogruppo principale

La scheda principale elenca tutti WinMDs (per gli elementi di WinRT) di SDK per la versione di destinazione di Windows.

i progetti di applicazioneWindows Store contengono riferimenti a qualsiasi WinMDs in Windows 8 SDK per impostazione predefinita la creazione del progetto.Nei progetti gestiti, un nodo di sola lettura nella cartella riferimenti in Esplora soluzioni il riferimento all'intero Windows 8 SDK.Pertanto, la scheda dello strumento di gestione dei riferimenti nessuno enumererà gli assembly da Windows 8 SDK ma non visualizza un messaggio: "Windows SDK è già fatto riferimento.Utilizzare il Visualizzatore oggetti per esplorare i riferimenti in Windows SDK."

Nei progetti del desktop la scheda principale non viene visualizzato per impostazione predefinita.È possibile aggiungere finestre runtime aprendo il menu di scelta rapida del nodo del progetto, scegliere Scarica progetto, aggiungendo il seguente frammento e la riapertura il progetto (sul nodo del progetto scegliere Ricarica progetto).Quando si richiama la finestra di dialogo Gestione riferimenti, la scheda principale viene visualizzato.

  <PropertyGroup>
    <TargetPlatformVersion>8.0</TargetPlatformVersion>
  </PropertyGroup>

Assicurarsi di controllare il contenitore di Windows in questa scheda.È quindi possibile utilizzare gli elementi di WinRT.

Hh708954.collapse_all(it-it,VS.110).gifSottogruppo le estensioni

Le estensioni sono elencati l'utente SDK che estendono la piattaforma di destinazione di Windows.Questa scheda viene visualizzato per i progetti di applicazione Windows Store solo.I progetti desktop non mostreranno questa scheda in quanto possono utilizzare solo i file della prima parte .winmd.

Un SDK è una raccolta di file in Visual Studio considera come un singolo componente.Nella scheda di estensioni, gli SDK che si applicano al progetto dalla finestra di dialogo Gestione riferimenti è stata richiamata vengono elencati come singole voci.Una volta aggiunto a un progetto, tutto il contenuto SDK viene utilizzato da Visual Studio in modo che l'utente non deve accettare nuove azioni l'utilizzo dei contenuti di SDK in IntelliSense, nella casella degli strumenti, nelle finestre di progettazione, nel Visualizzatore oggetti, nella compilazione, la distribuzione, il debug e nel pacchetto.Per informazioni su come visualizzare il SDK le estensioni scheda, vedere Procedura: creare una kit di sviluppo software.

[!NOTA]

Se i riferimenti al progetto un SDK che dipende da un altro SDK, Visual Studio non utilizzeranno il secondo SDK a meno che l'utente aggiunge manualmente un riferimento al secondo SDK.Quando un utente sceglie un SDK nella scheda Estensioni, la finestra di dialogo Gestione riferimenti guida all'utente di identificare le dipendenze di SDK per l'elenco non solo il nome e la versione di SDK ma anche il nome di tutte le dipendenze di SDK nel riquadro dei dettagli.Se un utente non nota le dipendenze e solo non aggiunge tale SDK, MSBuild in verrà chiesto di aggiungere dipendenze.

Se un tipo di progetto non supporta Estensioni, la scheda non viene visualizzata nella finestra di dialogo Gestione riferimenti.

Pulsante Sfoglia

È possibile utilizzare il pulsante Esplorare per selezionare un componente nel file system.

Un progetto può fare riferimento a un componente destinato 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 componente destinato a .NET Framework 2.Per ulteriori informazioni, vedere Scelta di una versione o profilo di .NET Framework specifico.

Evitare di aggiungere riferimenti di file agli output di un altro progetto nella stessa soluzione, poiché questa tattica può provocare errori di compilazione.In alternativa, utilizzare la scheda Soluzione la finestra di dialogo Gestione riferimenti per creare riferimenti da progetto a progetto.Questa tattica al team di sviluppo più semplice consentendo una migliore gestione delle librerie dei progetti.Per ulteriori informazioni, vedere Risoluzione dei problemi relativi ai riferimenti interrotti.

Non è possibile passare a un SDK e aggiungerlo al progetto.È possibile passare solo a un file, ad esempio un assembly o un .winmd) e aggiungerlo al progetto.

Nel creare un riferimento di file a un WinMD, il layout è previsto che [name] i file .winmd, nomefile [] file di tutti .pri] nomefile [e dll vengono posizionati accanto all'altro.Se si fa riferimento a un WinMD nei seguenti scenari, un set incompleto di file verrà copiato nella directory di output del progetto e, di conseguenza, la compilazione ed errori di runtime si verificano.

  • Componente nativo: un progetto nativo creato un WinMD per ognuno selezioni il set di spazi dei nomi e di una DLL costituito dall'implementazione.Il WinMDs avrà nomi diversi.Per fare riferimento a questo file del componente nativo, MSBuild non riconoscerà che il WinMDs diversamente denominato fa un componente.Di conseguenza, solo [name] il file dll in modo identico denominato e [name] .winmd file verrà copiato e gli errori di runtime si verificano.Per risolvere questo problema, creare un'estensione SDK.Per ulteriori informazioni, vedere Procedura: creare una kit di sviluppo software.

  • Utilizzare i controlli: come minimo, un controllo XAML è costituito da un " [nome file .winmd], [name] file dll, [nome file .pri], [xamlname xaml] e [] imagename .jpg.Quando il progetto viene compilato, i file di risorse associate al riferimento di file non vengano copiati nella directory di output del progetto e solo [] nome file in .winmd, nomefile [] .dll e [name] .pri file verranno copiati.Un errore di compilazione viene registrato per informare l'utente che le risorse [xamlname xaml] e [] imagename .jpg mancano.Per gestire, l'utente dovrà copiare manualmente questi file di risorse nella directory di output del progetto per la compilazione e debug/runtime.Per risolvere questo problema, creare un'estensione SDK seguendo i passaggi di Procedura: creare una kit di sviluppo software o modificare il file di progetto per aggiungere la seguente proprietà:

    <PropertyGroup>
    <GenerateLibraryOutput>True</GenerateLibraryOutput>
    </PropertyGroup>
    

    [!NOTA]

    Se si aggiunge la proprietà, la compilazione può essere più lenta.

Recente

Gli assembly, COM, Windows e passare ogni supporto una scheda recente, che enumerano l'elenco dei componenti di recente sono state aggiunte ai progetti.

Cerca

La barra di ricerca nella finestra di dialogo Gestione riferimenti agisce sulla scheda allo stato attivo.Ad esempio, se l'utente digita "sistema" nella barra di ricerca mentre la scheda della soluzione è dello stato attivo, la ricerca non restituiranno alcuni risultati a meno che la soluzione sia costituita da un nome di progetto contenente "sistema".

Vedere anche

Attività

Procedura: aggiungere o rimuovere riferimenti utilizzando la finestra di dialogo Aggiungi riferimento

Concetti

Gestione di riferimenti a progetti