Felsöka brutna referenser
Gäller för: Visual Studio
Om programmet försöker använda en bruten referens genereras ett undantagsfel. Den främsta orsaken till felet är oförmågan att hitta den refererade komponenten, men det finns flera scenarier där en referens anses vara bruten och de är:
- Projektets referenssökväg är felaktig eller ofullständig.
- Den refererade filen har tagits bort.
- Den refererade filen har bytt namn.
- Nätverksanslutningen eller autentiseringen misslyckades.
- Den refererade COM-komponenten är inte installerad på datorn.
Följande avsnitt innehåller lösningar på dessa scenarier.
Obs!
Filer i sammansättningar refereras till med absoluta sökvägar i projektfilen. Därför kan användare som arbetar i en miljö för flera utvecklare upptäcka att de saknar en refererad sammansättning i sin lokala miljö. För att undvika dessa fel är det bättre att lägga till projekt-till-projekt-referenser. Mer information finns i Sammansättningar i .NET.
Referenssökvägen är felaktig eller ofullständig
Om projekt delas på olika datorer kanske vissa referenser inte hittas när en komponent finns i en annan katalog. Referenser lagras under namnet på komponentfilen (till exempel MyComponent). När du lägger till en referens till ett projekt läggs mappplatsen för komponentfilen (till exempel C:\MyComponents) till i projektegenskapen ReferencePath .
När du öppnar ett projekt söker Visual Studio i katalogerna på referenssökvägen för att försöka hitta dessa komponentfiler. Om du öppnar projektet på en dator som lagrar komponenten i en annan katalog, till exempel D:\MyComponents, hittas inte referensen och ett fel visas i aktivitetslistan.
Åtgärda problemet genom att använda någon av följande metoder:
- Ta bort den brutna referensen och ersätt den sedan med hjälp av dialogrutan Lägg till referens .
- Använd objektet Referenssökväg på projektets egenskapssidor. Ändra mapparna i listan så att de pekar på rätt platser. Egenskapen Referenssökväg sparas för varje användare på varje dator. Därför påverkar inte ändringar av referenssökvägen andra användare av projektet.
Tips
Referenserna för projekt till projekt har inte dessa brutna referensproblem. Använd därför project-to-project-referenser i stället för filreferenser, om du kan.
Åtgärda en bruten projektreferens
Åtgärda en bruten projektreferens genom att korrigera referenssökvägen genom att följa dessa steg:
- Högerklicka på projektnoden i Solution Explorer och välj sedan Egenskaper. Project Designer visas.
- Om du använder Visual Basic väljer du sidan Referenser och sedan Referenssökvägar .
- I dialogrutan Referenssökvägar skriver du sökvägen till den mapp som innehåller det objekt som du vill referera till i fältet Mapp .
- Välj Lägg till mapp.
- Om du använder C# väljer du sidan Referenssökvägar .
- I fältet Mapp skriver du sökvägen till den mapp som innehåller det objekt som du vill referera till.
- Välj Lägg till mapp.
Refererad fil har tagits bort
Här är två alternativ för att åtgärda en bruten projektreferens för en borttagen fil som inte längre finns på enheten:
- Ta bort referensen.
- Om referensen finns på en annan plats på datorn läser du den från den platsen.
Den refererade filen har bytt namn
Här är två alternativ för att åtgärda en bruten referens för en fil som har bytt namn:
- Ta bort referensen och lägg sedan till en referens till den omdöpta filen.
- Om referensen finns på en annan plats på datorn läser du den från den platsen.
Nätverksanslutningen eller autentiseringen misslyckades
Det kan finnas många möjliga orsaker till otillgängliga filer. Det kan till exempel finnas en misslyckad nätverksanslutning eller en misslyckad autentisering. Omvänt kan varje orsak ha ett unikt sätt att återställa. Du kan till exempel behöva kontakta den lokala administratören för att få åtkomst till de resurser som krävs. Men att ta bort referensen och åtgärda koden som använde den är alltid ett alternativ.
Den refererade COM-komponenten är inte installerad på datorn
Om en användare lägger till en referens till en COM-komponent och en andra användare försöker köra koden på en dator som inte har den här komponenten installerad får den andra användaren ett brutet referensfel. Om du installerar komponenten på den andra datorn korrigeras felet. Mer information om hur du använder referenser till COM-komponenter i dina projekt finns i COM-samverkan i .NET Framework program.