dotnet add reference

  • Artikel

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

Name

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

Übersicht

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

dotnet add reference -h|--help

Beschreibung

Der dotnet add reference-Befehl bietet eine praktische Option zum Hinzufügen von Projektverweisen auf ein Projekt. Nachdem Sie den Befehl ausgeführt haben, werden die <ProjectReference>-Elemente zur Projektdatei hinzugefügt.

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

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

Es gibt keinen CLI-Befehl zum Hinzufügen eines Verweises auf eine Assembly, die sich nicht in einem Projekt oder Paket befindet. Sie können dazu jedoch Ihre CSPROJ-Datei bearbeiten und Markup wie im folgenden Beispiel hinzufügen:

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

Argumente

  • PROJECT

    Gibt die Projektdatei an. Wenn keine angegeben ist, sucht der Befehl im aktuellen Verzeichnis nach einer Projektdatei.

  • PROJECT_REFERENCES

    Hinzuzufügende Projekt-zu-Projekt (P2P)-Verweise. Geben Sie ein oder mehrere Projekte an. Globmuster werden auf Unix/Linux-basierten Systemen unterstützt.

Optionen

  • -f|--framework <FRAMEWORK>

    Fügt Projektverweise im TFM-Format nur hinzu, wenn auf ein bestimmtes Framework abgezielt 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

  • Projektverweis hinzufügen:

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

  • Fügen Sie dem Projekt im aktuellen Verzeichnis mehrere Projektverweise hinzu:

    dotnet add reference lib1/lib1.csproj lib2/lib2.csproj

  • Mehrere Projektverweise mithilfe eines Globmusters unter Linux/Unix hinzufügen:

    dotnet add app/app.csproj reference **/*.csproj