dotnet reference add

Ten artykuł dotyczy: ✔️ zestaw .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet reference add — dodaje odwołania do projektu (P2P).

Uwaga

Jeśli używasz zestawu .NET 9 SDK lub starszego, zamiast tego użyj formularza "czasownik pierwszy" (dotnet add reference). W programie .NET 10 wprowadzono formę "pierwszej ciołki". Aby uzyskać więcej informacji, zobacz Bardziej spójne kolejność poleceń.

Streszczenie

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

dotnet reference add -h|--help

Opis

Polecenie dotnet reference add zapewnia wygodną opcję dodawania odwołań do projektu. Po uruchomieniu polecenia do pliku projektu zostaną dodane elementy <ProjectReference>.

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

Dodawanie odwołania do zestawu, który nie znajduje się w projekcie

Nie ma polecenia interfejsu wiersza polecenia, aby dodać odwołanie do zestawu, który nie znajduje się w projekcie ani pakiecie. Można to jednak zrobić, edytując plik .csproj i dodając znaczniki podobne do następującego przykładu:

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

Argumenty (w programowaniu)

• PROJECT

  Określa plik projektu. Jeśli nie zostanie określony, polecenie przeszukuje bieżący katalog dla jednego.

• PROJECT_REFERENCES

  Odwołania do projektu (P2P) do dodania. Określ co najmniej jeden projekt. wzorce Glob są obsługiwane w systemach opartych na systemach Unix/Linux.

Opcje

• -f|--framework <FRAMEWORK>

  Dodaje odwołania do projektu tylko wtedy, gdy jest przeznaczona dla określonej platformy przy użyciu formatu TFM.

• -?|-h|--help

  Wyświetla opis sposobu używania polecenia .

• --interactive

  Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania. Dostępny od wersji .NET Core 3.0 SDK.

Przykłady

• Dodaj odwołanie do projektu:

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

• Dodaj zgodny język .NET (na przykład F#) odwołanie do projektu, które działa w obu kierunkach:

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

• Dodaj wiele odwołań do projektu w bieżącym katalogu:

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

• Dodaj wiele odwołań do projektu przy użyciu wzorca globbingu w systemie Linux/Unix:

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