共用方式為


針對 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 版本的參考元件。 實際使用的版本是由 TargetFrameworkVersionTargetFramework 屬性所決定,如項目檔中所定義。

還原專案

必須先還原包含套件參考的專案,才能建置這些專案。

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 還原動作會自動執行。

這很重要

使用參考元件,可讓您從命令行建置以不支援之 .NET Framework 版本為目標的專案。 不過,您仍然無法在較新版本的Visual Studio中載入這些專案。 若要繼續在Visual Studio中建置這些應用程式,唯一的因應措施是使用 舊版的Visual Studio