如何在Visual Studio中修复UWP项目的C#警告CA1416

问题场景 #

我的UWP项目最低版本设置为Windows 10 1809（10.0; Build 17763），但收到数千条重复警告：

This call site is reachable on all platforms. 'ValueSet.this[string]' is only supported on: 'Windows' 10.0.10240.0 and later.

按照微软文档建议使用以下特性解决时，出现编译错误：

[UnsupportedOSPlatform("windows")]
[SupportedOSPlatform("windows10.0.17763")]

错误信息：

CS0246: The type or namespace name 'UnsupportedOSPlatformAttribute' could not be found (are you missing a directive or an assembly reference?)
CS0246: The type or namespace name 'UnsupportedOSPlatform' could not be found (are you missing a directive or an assembly reference?)

一、解决特性引用失败的问题 #

1. 添加命名空间引用
   这两个特性属于System.Runtime.Versioning命名空间，在使用特性的代码文件顶部添加：

   using System.Runtime.Versioning;
   

2. 检查项目框架版本
   UnsupportedOSPlatformAttribute和SupportedOSPlatformAttribute是.NET 5及以后版本才引入的特性，传统UWP项目（基于.NET Framework）不支持。如果你的项目是旧版UWP，不要用这两个特性，改用UWP专属的[ApiContract]特性，或者调整代码分析规则。

3. 更新分析器包
   若项目是新版UWP（基于.NET 5+），尝试更新Microsoft.CodeAnalysis.FxCopAnalyzers NuGet包到最新版本，确保分析器能识别这些特性。

二、为什么版本高于10.0.10240仍出警告 #

1. 跨平台调用的误判
   代码分析器默认会假设你的代码可能被跨平台项目引用，所以即使UWP最低版本高于10240，它依然会提示该API仅支持Windows平台及10240以上版本，用来提醒你如果代码被非UWP项目调用会出问题。

2. 分析器未正确读取项目版本设置
   部分情况下，分析器没有正确读取UWP项目的最低版本配置，导致仍以Windows 10的初始版本（10240）作为基准检查API兼容性。

额外建议 #

如果是传统UWP项目，更实用的做法：

• 打开项目属性→代码分析，找到平台兼容性相关规则，调整其严重性为“无”；
• 确认代码不会被跨平台调用时，用#pragma warning disable XXX（XXX为警告编号）屏蔽特定警告；
• 若长期维护，建议迁移到Windows App SDK（WinUI 3），新框架对这些特性的支持更完善。

内容的提问来源于stack exchange，提问作者steam3d