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.

Nota

Ai file negli assembly viene fatto riferimento con percorsi assoluti nel file di progetto. Pertanto, gli utenti che lavorano in un ambiente multi-sviluppatore potrebbero scoprire di non avere un assembly a cui si fa riferimento nell'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 sotto il nome del file del componente, ad esempio MyComponent. 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 cercare questi file di componente. Se si apre il progetto in un computer che archivia 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 questo problema, usare uno dei metodi seguenti:

  • Eliminare il riferimento interrotto e quindi 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 puntino alle posizioni corrette. La proprietà Reference Path è persistente per ogni utente in ogni computer. Pertanto, la modifica del percorso di riferimento non influisce sugli altri utenti del progetto.

Consiglio

I riferimenti da progetto a progetto non presentano questi problemi di riferimento interrotti. Per questo motivo, se possibile, usare riferimenti da progetto a progetto anziché riferimenti a file.

Correzione di un riferimento al progetto danneggiato

Per correggere un riferimento al progetto interrotto, correggere il percorso di riferimento seguendo questa procedura:

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e quindi scegliere Proprietà. Viene visualizzata la Designer Progetto.
  2. Se si usa Visual Basic, selezionare la pagina Riferimenti e quindi selezionare Percorsi di riferimento .
    1. Nella finestra di dialogo Percorsi di riferimento digitare il percorso della cartella che contiene l'elemento a cui si vuole fare riferimento nel campo Cartella .
    2. Selezionare Aggiungi cartella.
  3. Se si usa C#, selezionare la pagina Percorsi di riferimento .
    1. Nel campo Cartella digitare il percorso della cartella che contiene l'elemento a cui si vuole fare riferimento.
    2. Selezionare Aggiungi cartella.

Il file a cui si fa riferimento è stato eliminato

Ecco due opzioni per correggere un riferimento al progetto interrotto per un file eliminato che non esiste più nell'unità:

  • Eliminare il riferimento.
  • Se il riferimento esiste in un'altra posizione del computer, leggerlo da tale 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 esiste in un'altra posizione del computer, leggerlo da tale posizione.

Connessione di rete o autenticazione non riuscita

Ci possono essere molte possibili cause per i file inaccessibili. Ad esempio, potrebbe essere presente una connessione di rete non riuscita 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 questo componente non è installato, 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 i riferimenti ai componenti COM nei progetti, vedere Interoperabilità COM nelle applicazioni .NET Framework.

Riferimenti