Apps bouwen op Basis van Microsoft.NETFramework.ReferenceAssemblies

Wanneer u zich richt op een bepaalde versie van .NET Framework, wordt uw toepassing standaard gebouwd met behulp van de referentieassembly's die zijn opgenomen in het ontwikkelaarspakket van die versie. In scenario's waarin het overeenkomende ontwikkelaarspakket niet op de computer kan worden geïnstalleerd, kunt u in plaats daarvan bouwen op referentieassembly's die worden gedistribueerd via een NuGet-pakket.

Projectbestanden bijwerken

Elk project dat moet worden gebouwd op basis van het NuGet-pakket voor referentieassembly's, moet een verwijzing naar Microsoft.NETFramework.ReferenceAssemblies bevatten.

Projecten die een packages.config-bestand gebruiken, moeten het volgende bevatten in packages.config.

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

Projecten die gebruikmaken van de <PackageReference> eigenschap MSBuild moeten de volgende eigenschap in het projectbestand bevatten.

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

Projecten in SDK-stijl bevatten standaard deze verwijzing. Voor typische .NET Framework-projecten die zijn gemaakt met Visual Studio, kunt u de verwijzing toevoegen met behulp van de gebruikersinterface van NuGet Package Manager in Visual Studio. Het pakket bevat referentieassembly's voor veel versies van .NET Framework. De versie die daadwerkelijk wordt gebruikt, wordt bepaald door de TargetFrameworkVersion of TargetFramework eigenschap, zoals al gedefinieerd in het projectbestand.

Het project herstellen

Projecten die een pakketreferentie bevatten, moeten worden hersteld voordat ze kunnen worden gebouwd.

Nadat u het NuGet-pakket Microsoft.NETFramework.ReferenceAssemblies aan uw project hebt toegevoegd, moet u de herstelactie expliciet uitvoeren op een van de volgende manieren:

• Als uw project een niet-SDK-project is en het bestandpackages.config gebruikt om te verwijzen naar NuGet-pakketten:

  1. Installeer het NuGet CLI-hulpprogramma en zorg ervoor dat nuget.exe zich in de PATH omgevingsvariabele bevindt.
  2. Open een opdrachtprompt.
  3. Navigeer naar de map met het projectbestand.
  4. Voer nuget.exe restoreuit.

• Als uw project een niet-SDK-project is en instellingen in het projectbestand gebruikt <PackageReference> om te verwijzen naar NuGet-pakketten:

  1. Open de opdrachtprompt voor ontwikkelaars voor VS 2022. De naam van deze app kan afwijken op basis van welke versie van Visual Studio u hebt geïnstalleerd.
  2. Navigeer naar de map met het projectbestand.
  3. Voer msbuild /t:restoreuit.

• Als uw project een SDK-project is, hoeft u niets te doen. De NuGet-herstelactie wordt automatisch uitgevoerd wanneer het project wordt gebouwd.

Belangrijk

Met behulp van referentieassembly's kunt u projecten bouwen die zich richten op niet-ondersteunde versies van .NET Framework vanaf de opdrachtregel. U kunt deze projecten echter nog steeds niet laden in nieuwere versies van Visual Studio. Als u wilt doorgaan met het bouwen van deze apps in Visual Studio, is de enige tijdelijke oplossing het gebruik van een oudere versie van Visual Studio.