FrameworkReference が Windows SDK の WindowsSdkPackageVersion に置き換えられました

[アーティクル]
05/10/2023

.NET 5.0.8 (.NET SDK 5.0.302 と .NET SDK 5.0.205 を含む) 以降では、Windows を対象とする開発者は、FrameworkReference 項目を使用して Windows SDK ターゲットパッケージのバージョンをオーバーライドすることはできません。 WindowsSdkPackageVersion プロパティがこの機能に取って代わります。

注意

Windows SDK バージョンのオーバーライドはお勧めしません。Windows SDK ターゲットパッケージが .NET 5+ SDK に含まれているためです。代わりに、最新の Windows SDK パッケージを参照する目的で、.NET SDK のバージョンを更新してください。

導入されたバージョン

.NET SDK 5.0.302、.NET SDK 5.0.205

以前の動作

開発者は FrameworkReference 項目を使用して .NET 5 アプリケーションの Windows SDK パッケージバージョンをオーバーライドできます。次に例を示します。

<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>

新しい動作

WindowsSdkPackageVersion プロパティが FrameworkReference オーバーライドの動作に取って代わります。例:

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

変更のカテゴリ

この変更はソースの互換性に影響を与えることがあります。

変更理由

この変更は、C#/WinRT によって作成される Windows SDK パッケージを対象にするパッケージオーバーライド動作を単純にする目的で導入されました。

推奨アクション

Windows SDK を対象にするとき、.NET 5+ アプリのプロジェクトファイルで FrameworkReference のあらゆる使用を削除します。

影響を受ける API

Windows SDK ターゲットパッケージによって提供される、.NET 5 以降のバージョンの Windows API。