Gewusst wie: Hinzufügen oder Entfernen von Verweisen in Visual Studio (Visual Basic)

  • Artikel

Aktualisiert: November 2007

Hinweis:

Das Verfahren zum Festlegen des Verweispfades ist bei Visual C#-Projekten etwas abgewandelt. Klicken Sie in einem Visual Basic-Projekt auf die Schaltfläche Verweispfade, um das Dialogfeld Verweis hinzufügen zu öffnen. Verwenden Sie in einem Visual C#-Projekt die Seite "Verweispfade", Projekt-Designer (C#) des Projekt-Designers. Weitere Informationen finden Sie unter Gewusst wie: Festlegen des Verweispfads (C#).

Um eine Komponente in einer Anwendung verwenden zu können, müssen Sie zunächst einen Verweis auf die Komponente hinzufügen. Visual Studio bietet dazu im Dialogfeld "Verweis hinzufügen" fünf Optionen:

  • .NET führt alle .NET Framework-Komponenten auf, die für Verweise verfügbar sind.

  • COM führt alle COM-Komponenten auf, die für Verweise verfügbar sind.

  • Projekte führt alle in lokalen Projekten erstellten wiederverwendbaren Komponenten auf.

  • Durchsuchen ermöglicht die Suche nach einer Komponente im Dateisystem.

  • Aktuell enthält eine Liste mit Komponenten, die kürzlich Projekten auf dem Computer hinzugefügt wurden.

Im Dialogfeld Verweis hinzufügen werden nur Assemblys im Ordner Public Assemblies aufgeführt (Programme\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies). Sie können eigene Assemblys in den Ordner Public Assemblies kopieren oder direkt zu ihnen navigieren. Beachten Sie, dass keine Verweise aus dem globalen Assemblycache (GAC) hinzugefügt werden können, da er Bestandteil der Laufzeitumgebung ist.

Hinweis:

Die Anzahl der Registerkarten, die im oberen Bereich des Dialogfelds Verweis hinzufügen verfügbar sind, kann je nach dem Typ des geöffneten Projekts und den davon verwendeten Ressourcen variieren. Darüber hinaus sind je nach .NET Framework-Version Ihres Projekts bestimmte Komponenten in der Liste deaktiviert und grau dargestellt. Der Grund hierfür ist, dass manche Komponenten einer neueren .NET Framework-Version nicht mit Projekten kompatibel sind, die auf einer früheren .NET Framework-Version basieren.

Wenn Sie eine Anwendung bereitstellen oder kopieren, die einen Verweis auf eine im GAC registrierte benutzerdefinierte Komponente enthält, wird die Komponente unabhängig von der Einstellung Copy Local nicht mit der Anwendung bereitgestellt oder kopiert. Weitere Informationen finden Sie unter Projektverweise.

Sie sollten keine Dateiverweise auf Ausgaben eines anderen Projekts in derselben Projektmappe hinzufügen, da dies zu Kompilierungsfehlern führen kann. Erstellen Sie Verweise zwischen Projekten stattdessen im Dialogfeld Verweis hinzufügen auf der Registerkarte Projekte. Dies erleichtert die Entwicklung im Team, da die in den Projekten erstellten Klassenbibliotheken besser verwaltet werden können. Weitere Informationen finden Sie unter Problembehandlung bei fehlerhaften Verweisen.

Wenn Sie einer registrierten COM DLL mit einem internen Manifest eine Referenz hinzufügen möchten, müssen Sie die Registrierung der DLL zunächst aufheben. Wenn Sie die Registrierung nicht aufheben, fügt Visual Studio den Assemblyverweis als ActiveX-Komponente und nicht als systemeigene DLL hinzu.

Mit dem Dialogfeld Webverweis hinzufügen können Sie auch Webverweise hinzufügen. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen und Entfernen von Webverweisen.

So zeigen Sie eine Assembly im Dialogfeld "Verweis hinzufügen" an

  • Verschieben oder kopieren Sie die Assembly in einen der folgenden Speicherorte:

    • Das aktuelle Projektverzeichnis. (Sie können die Assemblys über die Registerkarte Durchsuchen suchen.)

    • Andere Projektverzeichnisse in der gleichen Projektmappe. (Sie können die Assemblys über die Registerkarte Projekte suchen.)

    • Im Ordner Public Assemblies: (Programme\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies. (Sie finden diese Assemblys auf der Registerkarte .NET.)

  • Legen Sie über das Dialogfeld "Verweispfade" (Visual Basic) oder auf der Seite "Verweispfade", Projekt-Designer (C#) einen Verweispfad zu dem Verzeichnis fest, das die Assembly enthält.

  • Legen Sie einen Registrierungsschlüssel fest, der den Speicherort der anzuzeigenden Assemblys angibt:

    Fügen Sie einen der folgenden Registrierungsschlüssel hinzu. Dabei entspricht <Assembly-Speicherort> dem Verzeichnis der Assemblys, die im Dialogfeld Verweis hinzufügen angezeigt werden sollen, z. B. C:\MyAssemblies\.

    [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework \< Version >\AssemblyFoldersEx\MyAssemblies] @ ="< Assembly-Speicherort >"

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\<Version>\AssemblyFoldersEx\MyAssemblies]@="<Assembly-Speicherort>"

    Hinweis:

    Indem der Registrierungsschlüssel unter dem HKEY_LOCAL_MACHINE-Knoten erstellt wird, können die Assemblys am angegebenen Speicherort von allen Benutzern im Dialogfeld Verweis hinzufügen angezeigt werden. Wenn der Registrierungsschlüssel unter dem HKEY_CURRENT_USER-Knoten erstellt wird, hat dies nur Einfluss auf die Einstellung für den aktuellen Benutzer.

    Rufen Sie das Dialogfeld Verweis hinzufügen erneut auf. Die Assemblys sollten auf der Registerkarte .NET angezeigt werden. Stellen Sie anderenfalls sicher, dass sich die Assemblys im angegebenen Verzeichnis für den <AssemblyLocation> befinden, starten Sie Visual Studio neu, und versuchen Sie es noch einmal.

So fügen Sie einen Verweis in Visual Basic hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten My Project für das Projekt.

  2. Klicken Sie im Projekt-Designer auf die Registerkarte Verweise.

  3. Klicken Sie auf die Schaltfläche Hinzufügen, um das Dialogfeld Verweise hinzufügen zu öffnen.

  4. Wählen Sie im Dialogfeld Verweise hinzufügen die Registerkarte aus, die den Typ der Komponente angibt, auf die verwiesen werden soll.

  5. Wählen Sie die Komponenten aus, auf die verwiesen werden soll, und klicken Sie dann auf OK.

    Tipp:

    Sie können mehrere Komponenten auswählen, indem Sie beim Klicken STRG gedrückt halten. Die Komponenten müssen sich dazu jedoch auf derselben Registerkarte befinden.

So fügen Sie einen Verweis in Visual C# hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und klicken Sie dann auf Verweis hinzufügen.

  2. Wählen Sie im Dialogfeld Verweise hinzufügen die Registerkarte aus, die den Typ der Komponente angibt, auf die verwiesen werden soll.

  3. Wählen Sie die Komponenten aus, auf die verwiesen werden soll, und klicken Sie dann auf OK.

    Tipp:

    Sie können mehrere Komponenten auswählen, indem Sie beim Klicken STRG gedrückt halten. Die Komponenten müssen sich dazu jedoch auf derselben Registerkarte befinden.

So entfernen Sie einen Verweis in Visual Basic

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten My Project für das Projekt.

  2. Klicken Sie im Projekt-Designer auf die Registerkarte Verweise.

  3. Wählen Sie in der Liste Verweise den Verweis aus, den Sie entfernen möchten.

  4. Klicken Sie auf die Schaltfläche Entfernen.

    Tipp:

    Sie können ein Projekt auch auf nicht verwendete Verweise überprüfen und diese in einem Schritt entfernen. Weitere Informationen finden Sie unter Gewusst wie: Entfernen von nicht verwendeten Verweisen (Visual Basic).

So entfernen Sie einen Verweis in Visual C#

  1. Öffnen Sie im Projektmappen-Explorer den Knoten Verweise unter dem Projektknoten.

  2. Klicken Sie mit der rechten Maustaste auf einen Verweis, und klicken Sie auf Entfernen.

    Tipp:

    Sie können ein Projekt auch auf nicht verwendete Verweise überprüfen und diese in einem Schritt entfernen. Weitere Informationen finden Sie unter Gewusst wie: Entfernen von nicht verwendeten Verweisen (Visual Basic).

So legen Sie einen Verweispfad in Visual Basic fest

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten My Project für das Projekt.

  2. Klicken Sie im Projekt-Designer auf die Registerkarte Verweise.

  3. Klicken Sie auf die Schaltfläche Verweispfade.

  4. Geben Sie im Dialogfeld Verweispfade im Feld Ordner den vollständigen Pfad des Ordners ein, der die Komponenten enthält.

  5. Klicken Sie auf die Schaltfläche Ordner hinzufügen und dann auf OK.

    Hinweis:

    Beim Öffnen des Dialogfelds Verweis hinzufügen wird lediglich der angegebene Ordner durchsucht, Unterordner werden ignoriert. Sie müssen für jedes zu durchsuchende Unterverzeichnis einen separaten Pfad angeben.

So legen Sie einen Verweispfad in Visual C# fest

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und klicken Sie dann auf Eigenschaften.

  2. Klicken Sie im Projekt-Designer auf die Registerkarte Verweispfade.

  3. Geben Sie im Feld Ordner den vollständigen Pfad des Ordners ein, der die Komponenten enthält.

  4. Klicken Sie auf die Schaltfläche Ordner hinzufügen und dann auf OK.

    Hinweis:

    Beim Öffnen des Dialogfelds Verweis hinzufügen wird lediglich der angegebene Ordner durchsucht, Unterordner werden ignoriert. Sie müssen für jedes zu durchsuchende Unterverzeichnis einen separaten Pfad angeben.

Siehe auch

Aufgaben

Problembehandlung bei fehlerhaften Verweisen

Gewusst wie: Hinzufügen oder Entfernen von importierten Namespaces (Visual Basic)

Gewusst wie: Entfernen von nicht verwendeten Verweisen (Visual Basic)

Gewusst wie: Festlegen der Eigenschaft Lokale Kopie eines Verweises

Gewusst wie: Hinzufügen neuer Projektelemente

Gewusst wie: Hinzufügen und Entfernen von Webverweisen

Konzepte

Projektverweise

Webverweise in Visual Studio

Weitere Ressourcen

Verwalten von Verweisen

Verweisen auf Namespaces und Komponenten