dotnet Referenz hinzufügen

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

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.

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