この記事では、プロジェクト ファイルを編集するか CLI を使用して、パッケージの依存関係を追加および削除する方法について説明します。
<PackageReference> 要素
<PackageReference>
プロジェクト ファイル要素の構造は次のとおりです。
<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />
Include
属性は、プロジェクトに追加するパッケージの ID を指定します。
Version
属性は、取得するバージョンを指定します。 バージョンは、 NuGet のバージョン 規則に従って指定されます。
次の例に示すように、条件を使用して、特定のターゲットでのみ使用できる依存関係を追加します。
<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />
前の例の依存関係は、その特定のターゲットに対してビルドが行われている場合にのみ有効です。 条件の $(TargetFramework)
は、プロジェクトで設定されている MSBuild プロパティです。 ほとんどの一般的な .NET アプリケーションでは、これを行う必要はありません。
依存関係の追加と削除
依存関係を追加および削除するには、プロジェクト ファイルを編集するか 、.NET CLI コマンドを使用します。
プロジェクト ファイルを編集する
依存関係を追加するには、<PackageReference>
要素内に<ItemGroup>
項目を追加します。 既存の <ItemGroup>
に追加することも、新しいを作成することもできます。
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
...
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
</ItemGroup>
</Project>
依存関係を削除するには、その <PackageReference>
項目をプロジェクト ファイルから削除します。
CLI を使用する
依存関係を追加するには、次の例に示すように、 dotnet package add コマンドを実行します。 (SDK バージョンの .NET 9 以前を使用している場合は、代わりに dotnet add package
フォームを使用してください)。
dotnet package add Microsoft.EntityFrameworkCore
依存関係を削除するには、次の例に示すように、 dotnet package remove コマンドを実行します。 (SDK バージョンの .NET 9 以前を使用している場合は、代わりに dotnet remove package
フォームを使用してください)。
dotnet package remove Microsoft.EntityFrameworkCore
ヒント
参照先パッケージの .targets または .props ファイルに復元操作への入力を含めないでください。 これらの入力には、
PackageReference
項目、ExcludeAssets
属性、使用する NuGet フィード、またはその他の NuGet 構成を含めることができます。 パッケージの .targets ファイルと .props ファイルは、NuGet の復元が完了するまで使用されません。 復元に必要なものは、パッケージの依存関係ではなく、プロジェクト ファイルまたはプロジェクト自体の .targets ファイル内にある必要があります。コンソール アプリケーションまたはクラス ライブラリで ASP.NET API を使用する場合は、プロジェクト ファイルに FrameworkReference 項目を追加します。
<FrameworkReference Include="Microsoft.AspNetCore.App" />
詳細については、「 ASP.NET Core 共有フレームワークの使用」を参照してください。
こちらもご覧ください
- プロジェクトファイルでのパッケージ参照
- dotnet package list コマンド
- 依存関係 (ライブラリ ガイダンス)
.NET