Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bevor Sie Code für eine externe Komponente oder einen verbundenen Dienst schreiben, muss Ihr Projekt zuerst einen Verweis darauf enthalten. Ein Verweis ist im Wesentlichen ein Eintrag in einer Projektdatei, der die Informationen enthält, die Visual Studio zum Suchen der Komponente oder des Diensts benötigt.
Wie Sie einen Verweis hinzufügen, hängt vom Projekttyp für den Code ab, an dem Sie arbeiten:
Wenn Sie im Projektmappen-Explorer einen Abhängigkeiten-Knoten sehen, können Sie mit der rechten Maustaste darauf klicken und im Kontextmenü Projektverweis hinzufügen auswählen.
Sie können auch mit der rechten Maustaste auf den Projektknoten klicken und"Projektverweis> auswählen.
Wenn im Projektmappen-Explorer ein Knoten "Verweise" angezeigt wird, können Sie mit der rechten Maustaste auf das Kontextmenü klicken, um "Verweis hinzufügen" auszuwählen.
Oder klicken Sie mit der rechten Maustaste auf den Projektknoten, und wählen Sie"Verweis> aus.
Weitere Informationen finden Sie unter So fügen Sie Verweise hinzu oder entfernen sie.
Sie können einen Verweis auf die folgenden Typen von Komponenten und Diensten hinzufügen:
.NET-Klassenbibliotheken oder -Assemblys
UWP-Anwendungen
COM-Komponenten
Andere Assemblys oder Klassenbibliotheken von Projekten in derselben Lösung
Freigegebene Projekte
XML-Webdienste
UWP-App-Referenzen
Die Universelle Windows-Plattform (UWP) bietet eine allgemeine App-Plattform für jedes Gerät, auf dem Windows ausgeführt wird. Informationen zum Erstellen einer UWP-App finden Sie im Lernprogramm: Erstellen Ihrer ersten Universellen Windows-Plattform-Anwendung in Visual Studio mit XAML und C#.
Projektverweise
UWP-Projekte (Universelle Windows-Plattform) können Verweise auf andere UWP-Projekte in der Projektmappe oder auf Windows 8.1-Projekte oder Binärdateien erstellen, vorausgesetzt, dass diese Projekte keine APIs verwenden, die in Windows 10 und höher veraltet sind. Weitere Informationen finden Sie unter Wechseln von Windows-Runtime 8 zu UWP.
Wenn Sie Sich dafür entscheiden, Windows 8.1-Projekte auf Windows 10 und höher umzugestalten, lesen Sie Portieren, Migrieren und Aktualisieren von Visual Studio-Projekten.
Tipp
Informationen zum Erstellen einer neuen UWP-App für Windows 10 und Windows 11 finden Sie unter Auswahl einer UWP-Version.
Erweiterungs-SDK-Verweise
Visual Basic-, C#-, C++- und JavaScript-Apps für die universelle Windows-Plattform (UWP) können auf Erweiterungs-SDKs verweisen, die auf Windows 8.1 abzielen, sofern diese Erweiterungs-SDKs keine APIs verwenden, die in Windows 10 und höher veraltet sind. Überprüfen Sie die Erweiterungs-SDK-Anbieterwebsite, um herauszufinden, ob auf sie von UWP-Apps verwiesen werden kann.
Wenn Sie feststellen, dass das Erweiterungs-SDK, auf das von Ihrer App verwiesen wird, nicht unterstützt wird, müssen Sie die folgenden Schritte ausführen:
Sehen Sie sich den Namen des Projekts an, das den Fehler verursacht. Die Plattform, auf die Ihr Projekt ausgerichtet ist, wird in Klammern neben dem Projektnamen angegeben. MyProjectName (Windows 8.1) bedeutet beispielsweise, dass Ihr Projekt "MyProjectName" auf die Plattformversion Windows 8.1 ausgerichtet ist.
Wechseln Sie zur Website des Anbieters, der das nicht unterstützte Erweiterungs-SDK besitzt, und installieren Sie die Version des Erweiterungs-SDK mit Abhängigkeiten, die mit der Version der Plattform kompatibel sind, auf die Ihr Projekt ausgerichtet ist.
Hinweis
Eine Möglichkeit, herauszufinden, ob ein Erweiterungs-SDK Abhängigkeiten von anderen Erweiterungs-SDKs hat, finden Sie im Reference Manager. Starten Sie Visual Studio neu, erstellen Sie ein neues C#-UWP-App-Projekt, und klicken Sie dann mit der rechten Maustaste auf das Projekt, und wählen Sie "Verweis hinzufügen" aus. Wechseln Sie zur Registerkarte "Windows ", dann zur Unterregisterkarte "Erweiterungen ", und wählen Sie das Erweiterungs-SDK aus. Sehen Sie sich den rechten Bereich im Verweis-Manager an. Wenn es Abhängigkeiten hat, werden sie dort aufgelistet.
Von Bedeutung
Wenn Ihr Projekt speziell auf Windows 10 ausgerichtet ist und das im vorherigen Schritt installierte Erweiterungs-SDK eine Abhängigkeit vom Microsoft Visual C++-Runtime-Paket aufweist, ist die Version von Microsoft Visual C++ Runtime Package, die mit Windows 10 kompatibel ist, v14.0 und wird mit Visual Studio installiert.
Wenn das Erweiterungs-SDK, das Sie im vorherigen Schritt installiert haben, Abhängigkeiten von anderen Erweiterungs-SDKs hat, wechseln Sie zu den Websites der Anbieter, die die Abhängigkeiten besitzen, und installieren Sie dann die Versionen dieser Abhängigkeiten, die mit der Version der Plattform kompatibel sind, auf die Ihr Projekt ausgerichtet ist.
Starten Sie Visual Studio neu, und öffnen Sie Ihre App.
Klicken Sie im Projekt mit der rechten Maustaste auf den Knoten "Verweise " oder "Abhängigkeiten" , der den Fehler verursacht hat, und wählen Sie dann " Verweis hinzufügen" aus.
Wählen Sie die Windows-Registerkarte, und dann die Unterregisterkarte Extensions. Deaktivieren Sie die Kontrollkästchen für die alten Erweiterungs-SDKs, und aktivieren Sie dann die Kontrollkästchen für die neuen Erweiterungs-SDKs. Wählen Sie OK aus.
Fügen Sie während der Entwurfsphase einen Verweis hinzu
Wenn Sie einen Verweis auf eine Assembly in Ihrem Projekt erstellen, sucht Visual Studio an den folgenden Speicherorten nach der Assembly:
Das aktuelle Projektverzeichnis. (Sie können die Assemblys über die Registerkarte Durchsuchen suchen.)
Andere Projektverzeichnisse in der gleichen Projektmappe. (Sie finden diese Assemblys auf der Registerkarte "Projekte ".)
Hinweis
- Alle Projekte enthalten einen impliziten Verweis auf mscorlib.
- Alle Projekte enthalten einen impliziten Verweis auf
System.Core, auch wennSystem.Coreaus der Liste der Verweise entfernt wird. - Visual Basic-Projekte enthalten einen impliziten Verweis auf Microsoft.VisualBasic.
Verweise auf geteilte Komponenten zur Laufzeit
Zur Laufzeit müssen sich Komponenten entweder im Ausgabepfad des Projekts oder im globalen Assemblycache (GAC) befinden. Wenn das Projekt einen Verweis auf ein Objekt enthält, das sich nicht an einem dieser Speicherorte befindet, müssen Sie den Verweis auf den Ausgabepfad des Projekts kopieren, wenn Sie das Projekt erstellen. Die CopyLocal Eigenschaft gibt an, ob diese Kopie erstellt werden muss. Wenn der Wert "True" lautet, wird der Verweis beim Erstellen des Projekts in das Projektverzeichnis kopiert. Wenn der Wert "False" lautet, wird der Verweis nicht kopiert.
Wenn Sie eine Anwendung bereitstellen, die einen Verweis auf eine benutzerdefinierte Komponente enthält, die im GAC registriert ist, wird die Komponente unabhängig von der CopyLocal Einstellung nicht mit der Anwendung bereitgestellt. In früheren Versionen von Visual Studio konnten Sie die CopyLocal Eigenschaft für einen Verweis festlegen, um sicherzustellen, dass die Assembly bereitgestellt wurde. Jetzt müssen Sie die Assembly manuell zum Ordner \Bin hinzufügen. Mit dieser Aktion werden alle benutzerdefinierten Code überprüft, wodurch das Risiko reduziert wird, benutzerdefinierten Code zu veröffentlichen, mit dem Sie nicht vertraut sind.
Standardmäßig wird die CopyLocal Eigenschaft auf "False" festgelegt, wenn sich die Assembly oder Komponente im globalen Assemblycache befindet oder eine Frameworkkomponente ist. Andernfalls wird der Wert auf True festgelegt. Projekt-zu-Projekt-Verweise werden immer auf true festgelegt.
Verweisen auf ein Projekt oder eine Assembly, das/die auf eine andere .NET-Version ausgerichtet ist
Sie können Anwendungen erstellen, die auf Projekte oder Assemblys verweisen, die auf eine andere Version von .NET abzielen. Sie können beispielsweise eine Anwendung erstellen, die auf .NET Framework 4.6 ausgerichtet ist und auf eine Assembly verweist, die auf .NET Framework 4.5 abzielt. Wenn Sie ein Projekt erstellen, das auf eine frühere Version von .NET abzielt, können Sie keinen Verweis in diesem Projekt auf ein Projekt oder eine Assembly festlegen, die auf eine neuere Version ausgerichtet ist.
Weitere Informationen finden Sie unter Framework-Zieladressierungsübersicht.
Projekt-zu-Projekt-Verweise
Projekt-zu-Projekt-Verweise sind Verweise auf Projekte, die Assemblys enthalten; Sie fügen Projektverweise mithilfe der Registerkarte "Projekte " im Dialogfeld "Verweis-Manager" hinzu. Visual Studio kann eine Assembly finden, wenn ein Pfad zum Projekt angegeben wird.
Wenn Sie über ein Projekt verfügen, das eine Assembly erzeugt, sollten Sie auf das Projekt verweisen und keinen Dateiverweis verwenden. Der Vorteil eines Projekt-zu-Projekt-Verweises besteht darin, dass eine Abhängigkeit zwischen den Projekten im Buildsystem erstellt wird. Das abhängige Projekt wird erstellt, wenn es seit dem letzten Erstellen des referenzierenden Projekts geändert wurde. Ein Dateiverweis erstellt keine Buildabhängigkeit, sodass es möglich ist, das referenzierende Projekt zu erstellen, ohne das abhängige Projekt zu erstellen, und der Verweis kann veraltet werden. (Das heißt, das Projekt kann auf eine zuvor integrierte Version des Projekts verweisen.) Dies kann dazu führen, dass mehrere Versionen einer einzelnen DLL im Bin-Verzeichnis erforderlich sind, was nicht möglich ist. Wenn dieser Konflikt auftritt, wird eine Meldung angezeigt, z. B. "Warnung: Die Abhängigkeit 'Datei' im Projekt 'Projekt' kann nicht in das Ausführungsverzeichnis kopiert werden, da sie den Verweis 'file' überschreiben würde.' Weitere Informationen finden Sie unter Problembehandlung bei fehlerhaften Verweisen und Vorgehensweise: Erstellen und Entfernen von Projektabhängigkeiten.
Hinweis
Ein Dateiverweis anstelle eines Projekt-zu-Projekt-Verweises wird erstellt, wenn die Zielversion von .NET Framework eines Projekts Version 4.5 ist und die Zielversion des anderen Projekts Version 2, 3, 3.5 oder 4.0 ist.
Geteilte Projektverweise
Im Gegensatz zu den meisten anderen Projekttypen verfügt ein freigegebenes Projekt über keine binäre Ausgabe. Stattdessen wird der Code in jedem Projekt kompiliert, das darauf verweist. Mit freigegebenen Projekten können Sie allgemeinen Code schreiben, auf den von vielen verschiedenen Anwendungsprojekten verwiesen wird. Der Code wird als Teil jedes referenzierenden Projekts kompiliert und kann Compilerdirektiven enthalten, um plattformspezifische Funktionen in die freigegebene Codebasis zu integrieren. Fügen Sie auf der Registerkarte Freigegebene Projekte im Dialogfeld "Verweis-Manager" einen Verweis auf ein freigegebenes Projekt hinzu.
Dateiverweise
Dateiverweise sind direkte Verweise auf Assemblys außerhalb des Kontexts eines Visual Studio-Projekts. Sie erstellen diese mithilfe der Registerkarte " Durchsuchen " des Dialogfelds "Verweis-Manager". Verwenden Sie einen Dateiverweis, wenn Sie nur über eine Assembly oder Komponente verfügen, und nicht das Projekt, das es als Ausgabe erstellt.