Freigeben über

Problembehandlung bei fehlerhaften Verweisen

  • Artikel

Gilt für: Visual Studio

Wenn die Anwendung versucht, einen fehlerhaften Verweis zu verwenden, wird ein Ausnahmefehler generiert. Der Hauptgrund für den Fehler ist die Unfähigkeit, die referenzierte Komponente zu finden, aber es gibt mehrere Szenarien, in denen ein Verweis als fehlerhaft betrachtet wird und sie sind:

  • Der Referenzpfad von Project ist falsch oder unvollständig.
  • Referenzierte Datei wurde gelöscht.
  • Referenzierte Datei wurde umbenannt.
  • Fehler bei der Netzwerkverbindung oder Authentifizierung.
  • Referenzierte COM-Komponente ist nicht auf dem Computer installiert.

Die nächsten Abschnitte enthalten Lösungen für diese Szenarien.

Notiz

Auf Dateien in Assemblys wird mit absoluten Pfaden in der Projektdatei verwiesen. Daher können Benutzer, die in einer Umgebung mit mehreren Entwicklern arbeiten, feststellen, dass in ihrer lokalen Umgebung eine referenzierte Assembly fehlt. Um diese Fehler zu vermeiden, ist es besser, Projekt-zu-Projekt-Verweise hinzuzufügen. Weitere Informationen finden Sie unter Assemblys in .NET.

Der Verweispfad ist falsch oder unvollständig.

Wenn Projekte auf verschiedenen Computern gemeinsam verwendet werden, werden einige Verweise möglicherweise nicht gefunden, wenn sich eine Komponente in einem anderen Verzeichnis befindet. Verweise werden unter dem Namen der Komponentendatei gespeichert (z.B. MeineKomponente). Wenn Sie einem Projekt einen Verweis hinzufügen, wird der Ordnerspeicherort der Komponentendatei (z . B. C:\MyComponents) an die ReferencePath-Projekteigenschaft angefügt.

Wenn Sie ein Projekt öffnen, sucht Visual Studio in den Verzeichnissen im Referenzpfad, um diese Komponentendateien zu versuchen und zu finden. Wenn Sie das Projekt auf einem Computer öffnen, auf dem die Komponente in einem anderen Verzeichnis gespeichert wird, z . B. D:\MyComponents, wird der Verweis nicht gefunden, und in der Vorgangsliste wird ein Fehler angezeigt.

Verwenden Sie zur Problembehebung eine der folgenden Methoden:

  • Löschen Sie den fehlerhaften Verweis, und ersetzen Sie ihn dann mithilfe des Dialogfelds "Verweis hinzufügen".
  • Verwenden Sie das Element "Verweispfad " auf den Eigenschaftenseiten des Projekts. Ändern Sie die Ordner in der Liste so, dass sie auf die richtigen Speicherorte verweisen. Die Verweispfad-Eigenschaft wird für jeden Benutzer auf jedem Computer beibehalten. Deshalb hat eine Änderung Ihres Verweispfads keine Auswirkungen für andere Benutzer des Projekts.

Tipp

Project-to-Project-Verweise weisen diese fehlerhaften Referenzprobleme nicht auf. Verwenden Sie aus diesem Grund Project-zu-Projekt-Verweise anstelle von Dateiverweisen, falls möglich.

Beheben eines fehlerhaften Projektverweises

Um einen fehlerhaften Projektverweis zu beheben, korrigieren Sie den Referenzpfad anhand der folgenden Schritte:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Eigenschaften aus. Der Projekt-Designer wird angezeigt.
  2. Wenn Sie Visual Basic verwenden, wählen Sie die Seite "Verweise " und dann "Referenzpfade" aus.
    1. Geben Sie im Dialogfeld "Referenzpfade " den Pfad des Ordners ein, der das Element enthält, auf das Sie im Feld "Ordner" verweisen möchten.
    2. Wählen Sie "Ordner hinzufügen" aus.
  3. Wenn Sie C# verwenden, wählen Sie die Seite Verweispfade aus.
    1. Geben Sie im Feld "Ordner " den Pfad des Ordners ein, der das Element enthält, auf das Sie verweisen möchten.
    2. Wählen Sie "Ordner hinzufügen" aus.

Referenzierte Datei wurde gelöscht

Im Folgenden finden Sie zwei Optionen zum Beheben eines fehlerhaften Projektverweises für eine gelöschte Datei, die auf Ihrem Laufwerk nicht mehr vorhanden ist:

  • Löschen Sie den Verweis.
  • Wenn der Verweis auf dem Computer an einem anderen Speicherort vorhanden ist, lesen Sie ihn von diesem Speicherort.

Referenzierte Datei wurde umbenannt

Im Folgenden finden Sie zwei Optionen zum Beheben eines fehlerhaften Verweises für eine Datei, die umbenannt wurde:

  • Löschen Sie den Verweis, und fügen Sie dann einen Verweis auf die umbenannte Datei hinzu.
  • Wenn der Verweis auf dem Computer an einem anderen Speicherort vorhanden ist, lesen Sie ihn von diesem Speicherort.

Fehler beim Herstellen der Netzwerkverbindung oder der Authentifizierung

Es kann viele mögliche Ursachen für unzugängliche Dateien geben. Es kann z. B. eine fehlerhafte Netzwerkverbindung oder eine fehlerhafte Authentifizierung geben. Auf der anderen Seite gibt es für jede Ursache möglicherweise ein eigenes Mittel zur Wiederherstellung. Beispielsweise müssen Sie sich an den lokalen Administrator wenden, um auf die erforderlichen Ressourcen zuzugreifen. Es ist jedoch immer möglich, den Verweis zu löschen und den Code, in dem er verwendet wurde, entsprechend zu ändern.

Referenzierte COM-Komponente ist nicht auf dem Computer installiert

Wenn ein Benutzer einen Verweis auf eine COM-Komponente hinzufügt und ein zweiter Benutzer versucht, den Code auf einem Computer auszuführen, auf dem diese Komponente nicht installiert ist, erhält der zweite Benutzer einen fehlerhaften Verweisfehler. Der Fehler wird behoben, indem die Komponente auf dem zweiten Computer installiert wird. Weitere Informationen zur Verwendung von Verweisen auf COM-Komponenten in Projekten finden Sie unter COM-Interoperabilität in .NET Framework-Anwendungen.

References