Microsoft.NETFramework.ReferenceAssemblies に対してアプリをビルドする

特定のバージョンの .NET Framework を対象とする場合、既定では、そのバージョンの開発者パックに含まれている参照アセンブリを使用してアプリケーションがビルドされます。 一致する開発者パックをコンピューターにインストールできないシナリオでは、代わりに NuGet パッケージを介して配布される参照アセンブリに対してビルドできます。

プロジェクト ファイルを更新する

参照アセンブリ NuGet パッケージに対してビルドする必要がある各プロジェクトには、 Microsoft.NETFramework.ReferenceAssemblies への参照を含める必要があります。

packages.config ファイルを使用するプロジェクトは、packages.configに以下を含める必要があります。

<packages>
  <package id="Microsoft.NETFramework.ReferenceAssemblies" version="1.0.3" developmentDependency="true" />
</packages>

<PackageReference> MSBuild プロパティを使用するプロジェクトは、プロジェクト ファイルに次のプロパティを含める必要があります。

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
</ItemGroup>

SDK スタイルのプロジェクト には、既定でこの参照が含まれています。 Visual Studio で作成された一般的な .NET Framework プロジェクトでは、Visual Studio の NuGet パッケージ マネージャー UI を使用して参照を追加できます。 このパッケージには、多くのバージョンの .NET Framework の参照アセンブリが含まれています。 実際に使用されるバージョンは、プロジェクト ファイルで既に定義されている TargetFrameworkVersion または TargetFramework プロパティによって決まります。

プロジェクトを復元する

パッケージ参照を含むプロジェクトは、ビルドする前に復元する必要があります。

Microsoft.NETFramework.ReferenceAssemblies NuGet パッケージをプロジェクトに追加した後、次のいずれかの方法で復元アクションを明示的に実行する必要があります。

• プロジェクトが SDK スタイル以外のプロジェクトで、 packages.config ファイルを使用して NuGet パッケージを参照する場合:

  1. NuGet CLI ツールをインストールし、nuget.exe がPATH環境変数にあることを確認します。
  2. コマンド プロンプトを開きます。
  3. プロジェクト ファイルを含むディレクトリに移動します。
  4. nuget.exe restore を実行します。

• プロジェクトが SDK スタイル以外のプロジェクトで、プロジェクト ファイルの <PackageReference> 設定を使用して NuGet パッケージを参照する場合:

  1. VS 2022 の開発者コマンド プロンプトを開きます。 このアプリの名前は、インストールした Visual Studio のバージョンによって異なる場合があります。
  2. プロジェクト ファイルを含むディレクトリに移動します。
  3. msbuild /t:restore を実行します。

• プロジェクトが SDK スタイルのプロジェクトの場合は、何もする必要はありません。 NuGet 復元アクションは、プロジェクトのビルド時に自動的に実行されます。

Von Bedeutung

参照アセンブリを使用すると、サポートされていないバージョンの .NET Framework を対象とするプロジェクトをコマンド ラインからビルドできます。 ただし、これらのプロジェクトを新しいバージョンの Visual Studio に読み込むことはありません。 Visual Studio でこれらのアプリのビルドを続行するには、唯一の回避策は 、古いバージョンの Visual Studio を使用することです。