Skapa appar mot Microsoft.NETFramework.ReferenceAssemblies

När du riktar in dig på en viss version av .NET Framework skapas ditt program som standard med hjälp av referenssammansättningarna som ingår i den versionens utvecklarpaket. I scenarier där matchande utvecklarpaket inte kan installeras på datorn kan du skapa mot referenssammansättningar som distribueras via ett NuGet-paket i stället.

Uppdatera projektfiler

Varje projekt som ska byggas mot nuGet-referenspaketet måste innehålla en referens till Microsoft.NETFramework.ReferenceAssemblies.

Projekt som använder en packages.config fil bör innehålla följande i packages.config.

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

Projekt som använder <PackageReference> egenskapen MSBuild bör innehålla följande egenskap i projektfilen.

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

SDK-liknande projekt innehåller den här referensen som standard. För typiska .NET Framework-projekt som har skapats med Visual Studio kan du lägga till referensen med hjälp av NuGet Package Manager-användargränssnittet i Visual Studio. Paketet innehåller referenssammansättningar för många versioner av .NET Framework. Den version som faktiskt används bestäms av TargetFrameworkVersion egenskapen eller TargetFramework , som redan har definierats i projektfilen.

Återställa projektet

Projekt som innehåller en paketreferens måste återställas innan de kan skapas.

När du har lagt till NuGet-paketet Microsoft.NETFramework.ReferenceAssemblies i projektet måste du uttryckligen köra återställningsåtgärden på något av följande sätt:

• Om projektet inte är ett SDK-liknande projekt och använder filenpackages.config för att referera till NuGet-paket:

  1. Installera NuGet CLI-verktyget och kontrollera attnuget.exe finns i PATH miljövariabeln.
  2. Öppna kommando-prompten.
  3. Navigera till katalogen som innehåller projektfilen.
  4. Kör nuget.exe restore.

• Om projektet inte är ett SDK-liknande projekt och använder <PackageReference> inställningar i projektfilen för att referera till NuGet-paket:

  1. Öppna kommandotolken för utvecklare för VS 2022. Namnet på den här appen kan vara annorlunda beroende på vilken version av Visual Studio du har installerat.
  2. Navigera till katalogen som innehåller projektfilen.
  3. Kör msbuild /t:restore.

• Om projektet är ett SDK-liknande projekt behöver du inte göra något. NuGet-återställningsåtgärden körs automatiskt när projektet skapas.

Viktigt!

Med hjälp av referenssammansättningar kan du skapa projekt som riktar sig mot versioner av .NET Framework som inte stöds från kommandoraden. Du kan dock fortfarande inte läsa in dessa projekt i nyare versioner av Visual Studio. Om du vill fortsätta att skapa dessa appar i Visual Studio är den enda lösningen att använda en äldre version av Visual Studio.