Udostępnij za pośrednictwem

Rozwiązywanie problemów z uszkodzonymi odwołaniami

  • Artykuł

Dotyczy: Visual Studio

Jeśli aplikacja spróbuje użyć uszkodzonego odwołania, zostanie wygenerowany błąd wyjątku. Główną przyczyną błędu jest niemożność znalezienia składnika, do którego odwołuje się odwołanie, ale istnieje kilka scenariuszy, w których odwołanie jest uważane za uszkodzone i są one:

  • Ścieżka referencyjna projektu jest nieprawidłowa lub niekompletna.
  • Plik, do którego odwołuje się odwołanie, został usunięty.
  • Nazwa pliku, do którego odwołuje się odwołanie, została zmieniona.
  • Połączenie sieciowe lub uwierzytelnianie nie powiodło się.
  • Przywoływany składnik COM nie jest zainstalowany na komputerze.

Kilka następnych sekcji zawiera rozwiązania tych scenariuszy.

Uwaga

Do plików w zestawach są przywoływane ścieżki bezwzględne w pliku projektu. W związku z tym użytkownicy, którzy pracują w środowisku wielu deweloperów, mogą stwierdzić, że w środowisku lokalnym brakuje im zestawu, do którego odwołuje się odwołanie. Aby uniknąć tych błędów, lepiej jest dodać odwołania projektu do projektu. Aby uzyskać więcej informacji, zobacz Zestawy na platformie .NET.

Ścieżka referencyjna jest nieprawidłowa lub niekompletna

Jeśli projekty są współużytkowane na różnych komputerach, niektóre odwołania mogą nie zostać znalezione, gdy składnik znajduje się w innym katalogu. Odwołania są przechowywane pod nazwą pliku składnika (na przykład MyComponent). Po dodaniu odwołania do projektu lokalizacja folderu pliku składnika (na przykład C:\MyComponents) jest dołączana do właściwości projektu ReferencePath .

Po otwarciu projektu program Visual Studio szuka katalogów w ścieżce referencyjnej, aby spróbować znaleźć te pliki składników. Jeśli projekt zostanie otwarty na komputerze przechowującym składnik w innym katalogu, takim jak D:\MyComponents, odwołanie nie zostanie znalezione i na liście zadań zostanie wyświetlony błąd.

Aby rozwiązać ten problem, użyj jednej z następujących metod:

  • Usuń przerwane odwołanie, a następnie zastąp je za pomocą okna dialogowego Dodawanie odwołania .
  • Użyj elementu Ścieżka odwołania na stronach właściwości projektu. Zmodyfikuj foldery na liście, aby wskazywały poprawne lokalizacje. Właściwość Ścieżka odwołania jest utrwalana dla każdego użytkownika na każdym komputerze. W związku z tym modyfikowanie ścieżki referencyjnej nie ma wpływu na innych użytkowników projektu.

Porada

Odwołania do projektu nie mają tych uszkodzonych problemów z odwołaniem. Z tego powodu użyj odwołań projektu do projektu zamiast odwołań do plików, jeśli to możliwe.

Naprawianie uszkodzonego odwołania do projektu

Aby rozwiązać problem z uszkodzonym odwołaniem do projektu, popraw ścieżkę referencyjną, wykonując następujące kroki:

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu, a następnie wybierz pozycję Właściwości. Zostanie wyświetlony Projektant Projektu.
  2. Jeśli używasz języka Visual Basic, wybierz stronę Odwołania , a następnie wybierz pozycję Ścieżki referencyjne .
    1. W oknie dialogowym Ścieżki odwołania wpisz ścieżkę folderu zawierającego element, do którego chcesz się odwołać w polu Folder .
    2. Wybierz pozycję Dodaj folder.
  3. Jeśli używasz języka C#, wybierz stronę Ścieżki referencyjne .
    1. W polu Folder wpisz ścieżkę folderu zawierającego element, do którego chcesz się odwołać.
    2. Wybierz pozycję Dodaj folder.

Plik, do którego odwołuje się odwołanie, został usunięty

Poniżej przedstawiono dwie opcje naprawy uszkodzonego odwołania do projektu dla usuniętego pliku, który już nie istnieje na dysku:

  • Usuń odwołanie.
  • Jeśli odwołanie istnieje w innej lokalizacji na komputerze, odczytaj je z tej lokalizacji.

Nazwa pliku, do którego odwołuje się odwołanie, została zmieniona

Poniżej przedstawiono dwie opcje naprawy uszkodzonego odwołania do pliku, którego nazwa została zmieniona:

  • Usuń odwołanie, a następnie dodaj odwołanie do pliku o zmienionej nazwie.
  • Jeśli odwołanie istnieje w innej lokalizacji na komputerze, odczytaj je z tej lokalizacji.

Połączenie sieciowe lub uwierzytelnianie nie powiodło się

Może istnieć wiele możliwych przyczyn niedostępnych plików. Na przykład może wystąpić nieudane połączenie sieciowe lub nieudane uwierzytelnianie. Z drugiej strony każda przyczyna może mieć unikatowy sposób odzyskiwania. Na przykład może być konieczne skontaktowanie się z administratorem lokalnym w celu uzyskania dostępu do wymaganych zasobów. Jednak usunięcie odwołania i naprawienie kodu, który go używał, jest zawsze opcją.

Przywoływany składnik COM nie jest zainstalowany na komputerze

Jeśli użytkownik doda odwołanie do składnika COM, a drugi użytkownik spróbuje uruchomić kod na komputerze, na który nie zainstalowano tego składnika, drugi użytkownik otrzyma uszkodzony błąd odwołania. Zainstalowanie składnika na drugim komputerze poprawia błąd. Aby uzyskać więcej informacji na temat używania odwołań do składników COM w projektach, zobacz Współdziałanie COM w aplikacjach .NET Framework.

Informacje