Risolvere i problemi relativi ai riferimenti interrotti
Si applica a: Visual Studio
Se l'applicazione tenta di usare un riferimento interrotto, viene generato un errore di eccezione. Il motivo principale dell'errore è l'impossibilità di trovare il componente a cui si fa riferimento, ma esistono diversi scenari in cui un riferimento viene considerato interrotto e sono:
- Il percorso di riferimento del progetto non è corretto o incompleto.
- Il file a cui si fa riferimento è stato eliminato.
- Il file a cui si fa riferimento è stato rinominato.
- Connessione di rete o autenticazione non riuscita.
- Il componente COM a cui si fa riferimento non è installato nel computer.
Le sezioni successive forniscono soluzioni a questi scenari.
Note
Nel file di progetto si fa riferimento ai file contenuti negli assembly tramite percorsi assoluti. Pertanto, gli utenti che lavorano in un ambiente multi-sviluppatore potrebbero scoprire che manca un assembly di riferimento nel proprio ambiente locale. Per evitare questi errori, è preferibile aggiungere riferimenti da progetto a progetto. Per altre informazioni, vedere Assembly in .NET.
Il percorso di riferimento non è corretto o incompleto
Se i progetti vengono condivisi in computer diversi, alcuni riferimenti potrebbero non essere trovati quando un componente si trova in una directory diversa. I riferimenti vengono archiviati con il nome del file del componente, ad esempio Componente. Quando si aggiunge un riferimento a un progetto, il percorso della cartella del file del componente , ad esempio C:\MyComponents, viene aggiunto alla proprietà del progetto ReferencePath.
Quando si apre un progetto, Visual Studio cerca nelle directory nel percorso di riferimento per provare a trovare questi file di componente. Se si apre il progetto in un computer in cui è archiviato il componente in una directory diversa, ad esempio D:\MyComponents, il riferimento non verrà trovato e verrà visualizzato un errore nell'elenco attività.
Per risolvere il problema, usare uno dei metodi seguenti:
- Eliminare il riferimento interrotto e sostituirlo usando la finestra di dialogo Aggiungi riferimento .
- Utilizzare l'elemento Percorso di riferimento nelle pagine delle proprietà del progetto. Modificare le cartelle nell'elenco in modo che punti ai percorsi corretti. La proprietà ReferencePath viene mantenuta per ogni utente in ogni computer. Pertanto, la modifica del percorso di riferimento non influisce sugli altri utenti del progetto.
Suggerimento
I riferimenti da progetto a progetto non presentano questi problemi di riferimento interrotti. Per questo motivo, usare riferimenti da progetto a progetto anziché riferimenti a file, se possibile.
Correzione di un riferimento al progetto interrotto
Per correggere un riferimento al progetto interrotto, correggere il percorso di riferimento seguendo questa procedura:
- In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e quindi scegliere Proprietà. Viene visualizzata la finestra Creazione progetti.
- Se si usa Visual Basic, selezionare la pagina Riferimenti e quindi selezionare Percorsi di riferimento.
- Nella finestra di dialogo Percorsi di riferimento digitare il percorso della cartella contenente l'elemento a cui si desidera fare riferimento nel campo Cartella.
- Selezionare Aggiungi cartella.
- Se si usa C#, selezionare la pagina Percorsi di riferimento.
- Nel campo Cartella digitare il percorso della cartella contenente l'elemento a cui si desidera fare riferimento.
- Selezionare Aggiungi cartella.
Il file di riferimento è stato eliminato
Ecco due opzioni per correggere un riferimento di progetto interrotto per un file eliminato che non esiste più nell'unità:
- Eliminare il riferimento.
- Se il riferimento si trova in un'altra posizione all'interno del computer, leggerlo da quella posizione.
Il file a cui si fa riferimento è stato rinominato
Ecco due opzioni per correggere un riferimento interrotto per un file rinominato:
- Eliminare il riferimento e quindi aggiungere un riferimento al file rinominato.
- Se il riferimento si trova in un'altra posizione all'interno del computer, leggerlo da quella posizione.
Errore durante la connessione o l'autenticazione di rete
Esistono molte possibili cause per i file inaccessibili. Ad esempio, potrebbe verificarsi un errore di connessione di rete o un'autenticazione non riuscita. Al contrario, ogni causa potrebbe avere un mezzo univoco di ripristino. Ad esempio, potrebbe essere necessario contattare l'amministratore locale per accedere alle risorse necessarie. Tuttavia, l'eliminazione del riferimento e la correzione del codice usato è sempre un'opzione.
Il componente COM a cui si fa riferimento non è installato nel computer
Se un utente aggiunge un riferimento a un componente COM e un secondo utente tenta di eseguire il codice in un computer in cui non è installato questo componente, il secondo utente riceve un errore di riferimento interrotto. L'installazione del componente nel secondo computer corregge l'errore. Per altre informazioni su come usare riferimenti a componenti COM nei progetti, vedere Interoperabilità COM nelle applicazioni .NET Framework.