dotnet reference add

2025-04-03

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

Name

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

Hinweis

Wenn Sie .NET 9 SDK oder früher verwenden, verwenden Sie stattdessen das Formular "verb first" (dotnet add reference). Das Formular "Nomen first" wurde in .NET 10 eingeführt. Weitere Informationen finden Sie unter "Konsistentere Befehlsreihenfolge".

Zusammenfassung

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

dotnet reference add -h|--help

BESCHREIBUNG

Der Befehl dotnet reference add 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 zur Verwendung des Befehls aus.

--interactive

Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen. Verfügbar seit .NET Core 3.0 SDK.

Beispiele

Hinzufügen eines Projektverweises:

dotnet reference add lib/lib.csproj --project app/app.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 reference add lib1/lib1.csproj lib2/lib2.csproj
```
Fügen Sie mehrere Projektverweise mithilfe eines globbing-Musters unter Linux/Unix hinzu:
```
dotnet reference add **/*.csproj --project app/app.csproj
```

Freigeben über