dotnet add reference

Artikel
12/27/2024

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höhere Versionen

Name

dotnet add reference – Fügt Projekt-zu-Projekt-Verweise (P2P) hinzu.

Zusammenfassung

dotnet add [<PROJECT>] reference [-f|--framework <FRAMEWORK>]
     [--interactive] <PROJECT_REFERENCES>

dotnet add reference -h|--help

Beschreibung

Der Befehl dotnet add reference bietet eine bequeme Option zum Hinzufügen von Projektverweisen zu einem Projekt. Nach dem Ausführen des Befehls werden die <ProjectReference> Elemente der Projektdatei hinzugefügt.

<ItemGroup>
  <ProjectReference Include="app.csproj" />
  <ProjectReference Include="..\lib2\lib2.csproj" />
  <ProjectReference Include="..\lib1\lib1.csproj" />
  <ProjectReference Include="..\lib3\lib3.fsproj" />
</ItemGroup>

Hinzufügen eines Verweises auf eine Assembly, die sich nicht in einem Projekt befindet

Es gibt keinen CLI-Befehl, um einen Verweis auf eine Assembly hinzuzufügen, die sich nicht in einem Projekt oder einem Paket befindet. Sie können dies jedoch tun, indem Sie Ihre CSPROJ--Datei bearbeiten und markup ähnlich dem folgenden Beispiel hinzufügen:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>.\MyDLLFolder\MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Argumente

PROJECT

Gibt die Projektdatei an. Wenn nicht angegeben, durchsucht der Befehl das aktuelle Verzeichnis nach einem Verzeichnis.
PROJECT_REFERENCES

Project-to-Project(P2P)-Verweise, die hinzugefügt werden sollen. Geben Sie ein oder mehrere Projekte an. Glob Patterns werden auf Unix/Linux-basierten Systemen unterstützt.

Optionen

-f|--framework <FRAMEWORK>

Fügt Projektverweise nur hinzu, wenn ein bestimmtes Framework mithilfe des TFM-Formats verwendet wird.

-?|-h|--help

Gibt eine Beschreibung der Verwendung des Befehls aus.

--interactive

Ermöglicht es dem Befehl, die Benutzereingabe oder -aktion zu beenden und zu warten. Um beispielsweise die Authentifizierung abzuschließen. Verfügbar seit .NET Core 3.0 SDK.

Beispiele

Hinzufügen eines Projektverweises:

dotnet add app/app.csproj reference lib/lib.csproj

Fügen Sie eine kompatible .NET-Sprache (z. B. F#)-Projektreferenz hinzu, die in beide Richtungen funktioniert:
```
dotnet add app/app.csproj reference lib/lib.fsproj
```
Fügen Sie dem Projekt im aktuellen Verzeichnis mehrere Projektverweise hinzu:
```
dotnet add reference lib1/lib1.csproj lib2/lib2.csproj
```
Fügen Sie mehrere Projektverweise mithilfe eines globbing-Musters unter Linux/Unix hinzu:
```
dotnet add app/app.csproj reference **/*.csproj
```

Freigeben über