重写TextBox派生控件Text属性时遇可空性不匹配警告，如何解决？

你在多目标（.NET Framework + .NET Core/.NET 5+）项目中重写TextBox的Text属性时，遇到了空值匹配警告：

nullability of type of parameter 'value' doesn't match overridden member (possibly because of nullability attributes).

涉及代码片段：

public override string Text
{
    get => _labelText;

    set
    {
        _labelText = value!;
        Invalidate();
    }
}

问题根源 #

不同框架下基类TextBox.Text的nullable签名存在差异：

• .NET Framework中，基类Text无nullable注解，在启用nullable上下文时，编译器会将其视为可能为空的引用类型
• .NET Core/.NET 5+中，基类Text被标注为string?，明确允许空值

解决方案 #

通过条件编译匹配不同框架的签名，同时安全处理空值输入，避免强制非空的潜在风险：

方案1：简洁的条件编译属性类型 #

public override string
#if !NETFRAMEWORK
?
#endif
Text
{
    get => _labelText;

    set
    {
        // 用空字符串替代null，保证属性值始终非空
        _labelText = value ?? string.Empty;
        Invalidate();
    }
}

方案2：分框架完整定义属性（可读性更强） #

#if NETFRAMEWORK
public override string Text
#else
public override string? Text
#endif
{
    get => _labelText;

    set
    {
        _labelText = value ?? string.Empty;
        Invalidate();
    }
}

辅助配置（可选） #

如果项目全局启用了nullable规则，可针对.NET Framework单独调整，减少不必要的警告：
在项目文件（.csproj）中添加：

<PropertyGroup>
  <!-- 全局启用nullable检查 -->
  <Nullable>enable</Nullable>
  <!-- 针对.NET Framework仅显示nullable警告，不强制严格约束 -->
  <Nullable Condition="'$(TargetFramework)' == 'net48'">warnings</Nullable>
</PropertyGroup>

关键注意点 #

• 避免使用value!强制非空：这种写法会绕过编译器检查，可能在运行时引发空引用异常
• value ?? string.Empty的处理方式符合WinForms控件Text属性的常规行为，保证属性值始终有效
• 条件编译符号NETFRAMEWORK是.NET项目默认定义的，无需额外配置

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