Rozwiązywanie problemów z przerwanymi odwołaniami
Dotyczy: Visual Studio
Jeśli aplikacja próbuje użyć uszkodzonego odwołania, zostanie wygenerowany błąd wyjątku. Głównym powodem błędu jest brak możliwości znalezienia składnika, do którego odwołuje się odwołanie, ale istnieje kilka scenariuszy, w których odwołanie jest uznawane za uszkodzone i są następujące:
- Ścieżka referencyjna projektu jest niepoprawna lub niekompletna.
- Odwołany plik został usunięty.
- Zmieniono nazwę przywoływał plik.
- Połączenie sieciowe lub uwierzytelnianie nie powiodło się.
- Na komputerze nie zainstalowano przywoływanego składnika COM.
W następnych kilku sekcjach przedstawiono rozwiązania tych scenariuszy.
Uwaga 16.
Pliki w zestawach są przywołyne ze ścieżkami bezwzględnymi w pliku projektu. W związku z tym użytkownicy pracujący w środowisku z wieloma deweloperami mogą stwierdzić, że w środowisku lokalnym brakuje przywołynego zestawu. Aby uniknąć tych błędów, lepiej jest dodać odwołania do projektu do projektu. Aby uzyskać więcej informacji, zobacz Zestawy na platformie .NET.
Ścieżka odwołania jest niepoprawna 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 wyszukuje katalogi w ścieżce referencyjnej, aby spróbować znaleźć te pliki składników. Jeśli otworzysz projekt na komputerze, który przechowuje składnik w innym katalogu, takim jak D:\MyComponents, odwołanie nie zostanie znalezione i na liście zadań pojawi się błąd.
Aby rozwiązać ten problem, użyj jednej z następujących metod:
- Usuń uszkodzone odwołanie, a następnie zastąp je za pomocą okna dialogowego Dodawanie odwołania .
- Użyj elementu Ścieżka referencyjna na stronach właściwości projektu. Zmodyfikuj foldery na liście, aby wskazywały prawidłowe 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.
Napiwek
Odwołania do projektu nie mają tych uszkodzonych problemów z odwołaniami. Z tego powodu użyj odwołań project-to-project zamiast odwołań do plików, jeśli to możliwe.
Naprawianie uszkodzonego odwołania do projektu
Aby naprawić uszkodzone odwołanie do projektu, popraw ścieżkę odwołania, wykonując następujące kroki:
- W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu, a następnie wybierz polecenie Właściwości. Zostanie wyświetlony projektant projektu.
- Jeśli używasz języka Visual Basic, wybierz stronę Odwołania, a następnie wybierz pozycję Ścieżki odwołań.
- W oknie dialogowym Ścieżki odwołań wpisz ścieżkę folderu zawierającego element, do którego chcesz się odwołać w polu Folder.
- Wybierz pozycję Dodaj folder.
- Jeśli używasz języka C#, wybierz stronę Ścieżki referencyjne.
- W polu Folder wpisz ścieżkę folderu zawierającego element, do którego chcesz się odwołać.
- Wybierz pozycję Dodaj folder.
Usunięto przywoływalny plik
Poniżej przedstawiono dwie opcje naprawienia 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, należy go odczytać z tej lokalizacji.
Zmieniono nazwę pliku, do którego odwołuje się odwołanie
Poniżej przedstawiono dwie opcje naprawienia uszkodzonego odwołania do pliku, którego nazwa została zmieniona:
- Usuń odwołanie, a następnie dodaj odwołanie do zmienionego pliku.
- Jeśli odwołanie istnieje w innej lokalizacji na komputerze, należy go odczytać z tej lokalizacji.
Połączenie sieciowe lub uwierzytelnianie nie powiodło się
Istnieje 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ć unikatowe środki 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żył, jest zawsze opcją.
Na komputerze nie zainstalowano przywoływanego składnika COM
Jeśli użytkownik dodaje odwołanie do składnika COM, a drugi użytkownik próbuje uruchomić kod na komputerze, który nie ma zainstalowanego tego składnika, drugi użytkownik otrzymuje 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 modelu COM w aplikacjach .NET Framework.