Problembehandlung bei fehlerhaften Verweisen

Artikel
03/21/2023

Gilt für: Visual Studio

Wenn Ihre Anwendung versucht, einen fehlerhaften Verweis zu verwenden, wird ein Ausnahmefehler generiert. Der Standard Grund für den Fehler ist die Unfähigkeit, die komponente zu finden, auf die verwiesen wird, aber es gibt mehrere Szenarien, in denen ein Verweis als fehlerhaft angesehen wird, und zwar:

Der Verweispfad des Projekts ist falsch oder unvollständig.
Die Referenzdatei wurde gelöscht.
Die Referenzdatei wurde umbenannt.
Fehler bei der Netzwerkverbindung oder Authentifizierung.
Die COM-Komponente, auf die verwiesen wird, ist nicht auf dem Computer installiert.

In den nächsten Abschnitten finden Sie Lösungen für diese Szenarien.

Hinweis

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 Assembly fehlt, auf die verwiesen wird. 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. MyComponent). Wenn Sie einen Verweis auf ein Projekt 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 nach dem Verweispfad, um nach diesen Komponentendateien zu suchen. 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 Aufgabenliste wird ein Fehler angezeigt.

Verwenden Sie eine der folgenden Methoden, um dieses Problem zu beheben:

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 Eigenschaft Verweispfad wird für jeden Benutzer auf jedem Computer beibehalten. Daher wirkt sich das Ändern des Verweispfads nicht auf andere Benutzer des Projekts aus.

Tipp

Project-to-Project-Verweise weisen diese fehlerhaften Verweisprobleme nicht auf. Aus diesem Grund verwenden Sie projekt-zu-Projekt-Verweise anstelle von Dateiverweisen, wenn möglich.

Korrigieren eines fehlerhaften Projektverweises

Um einen fehlerhaften Projektverweis zu beheben, korrigieren Sie den Verweispfad, indem Sie die folgenden Schritte ausführen:

Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie dann Eigenschaften aus. Die Projekt-Designer wird angezeigt.
Wenn Sie Visual Basic verwenden, wählen Sie die Seite Verweise und dann Verweispfade aus.
1. Geben Sie im Dialogfeld Verweispfade 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.
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.

Die Referenzdatei wurde gelöscht.

Hier sind zwei Optionen, um einen fehlerhaften Projektverweis für eine gelöschte Datei zu beheben, die auf Ihrem Laufwerk nicht mehr vorhanden ist:

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

Die Referenzdatei wurde umbenannt.

Hier sind 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 an einem anderen Speicherort auf Ihrem Computer vorhanden ist, lesen Sie ihn von diesem Speicherort aus.

Fehler bei der Netzwerkverbindung oder Authentifizierung

Es kann viele mögliche Ursachen für nicht zugängliche Dateien geben. Es kann z. B. eine fehlerhafte Netzwerkverbindung oder eine fehlgeschlagene Authentifizierung geben. Umgekehrt kann jede Ursache ein eindeutiges Mittel zur Wiederherstellung haben. Beispielsweise müssen Sie sich möglicherweise an den lokalen Administrator wenden, um auf die erforderlichen Ressourcen zuzugreifen. Das Löschen des Verweises und das Korrigieren des Codes, der ihn verwendet hat, ist jedoch immer eine Option.

Die COM-Komponente, auf die verwiesen wird, 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. Wenn Sie die Komponente auf dem zweiten Computer installieren, wird der Fehler behoben. Weitere Informationen zur Verwendung von Verweisen auf COM-Komponenten in Ihren Projekten finden Sie unter COM-Interoperabilität in .NET Framework Anwendungen.

Freigeben über