FrameworkReference sostituito con WindowsSdkPackageVersion per Windows SDK

  • Articolo

A partire da .NET 5.0.8 (che include .NET SDK 5.0.302 e .NET SDK 5.0.205), gli sviluppatori per Windows non possono usare l'elemento FrameworkReference per eseguire l'override della versione del pacchetto destinato a Windows SDK. La proprietà WindowsSdkPackageVersion sostituisce questa funzionalità.

Nota

Non è consigliabile eseguire l'override della versione di Windows SDK, perché i pacchetti destinati a Windows SDK sono inclusi in .NET 5+ SDK. Al contrario, per fare riferimento al pacchetto Windows SDK più recente, aggiornare la versione di .NET SDK.

Versione introdotta

.NET SDK 5.0.302, .NET SDK 5.0.205

Comportamento precedente

Gli sviluppatori potevano usare l'elemento FrameworkReference per eseguire l'override della versione del pacchetto Windows SDK nelle applicazioni .NET 5. Ad esempio:

<ItemGroup>
  <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" RuntimeFrameworkVersion="10.0.19041.18" />
  <FrameworkReference Update="Microsoft.Windows.SDK.NET.Ref" TargetingPackVersion="10.0.19041.18" />
</ItemGroup>

Nuovo comportamento

La proprietà WindowsSdkPackageVersion sostituisce il comportamento dell'override FrameworkReference. Ad esempio:

<PropertyGroup>
  <WindowsSdkPackageVersion>10.0.19041.18</WindowsSdkPackageVersion>
</PropertyGroup>

Categoria della modifica

Questa modifica può influire sulla compatibilità dell'origine.

Motivo della modifica

Questa modifica è stata introdotta per semplificare il comportamento di override dei pacchetti destinati a Windows SDK prodotti da C#/WinRT.

Rimuovere qualsiasi uso di FrameworkReference nel file di progetto dell'app .NET 5+ quando è destinato a Windows SDK.

API interessate

API Windows in .NET 5 e versioni successive fornite dal pacchetto destinato a Windows SDK.