选项验证生成器针对显式验证实现报告 SYSLIB1205

从 .NET 11 RC 1 开始,选项验证源生成器会将对 IValidateOptions<TOptions>.Validate 的显式实现识别为手写实现。 它报告错误诊断 SYSLIB1205 ,而不是生成单独的公共同步 Validate 方法。

引入的版本

.NET 11 RC 1

以前的行为

以前,源生成器无法将显式实现 Validate(String, TOptions) 识别为现有实现。 它可以生成额外的公共 Validate 方法,因此接口调用使用手写实现,而对具体验证器的直接调用则使用生成的方法。 这两个调用路径可能会产生不同的验证结果。

[OptionsValidator]
public partial class MyValidator : IValidateOptions<MyOptions>
{
    ValidateOptionsResult IValidateOptions<MyOptions>.Validate(string? name, MyOptions options)
        => ValidateOptionsResult.Success;
}

新行为

从 .NET 11 开始,源生成器可识别显式实现,报告 SYSLIB1205,并禁止为该选项模型生成同步 Validate。

如果验证程序还实现 IAsyncValidateOptions<TOptions>,同步和异步生成将保持独立。 手写同步实现会生成 SYSLIB1205 并禁止生成的 Validate,但生成器仍可以发出 ValidateAsync。

破坏性变更的类型

此更改可能会影响 源兼容性。

更改原因

以前的行为允许接口调用使用手写验证,而直接调用则使用单独生成的验证。 识别显式实现可防止生成的验证逻辑被悄然绕过,并消除这些不同的验证路径。 有关详细信息,请参阅 dotnet/runtime#130263。

为同步 Validate 实现选择一个所有者。

若要使用源生成的验证,请保留 [OptionsValidator] 并删除手写显式实现:

[OptionsValidator]
public partial class MyValidator : IValidateOptions<MyOptions>
{
}

若要手动掌控验证,请删除 [OptionsValidator] 并自行实现完整的验证程序:

public sealed class MyValidator : IValidateOptions<MyOptions>
{
    public ValidateOptionsResult Validate(string? name, MyOptions options)
        => ValidateOptionsResult.Success;
}

没有兼容性开关。 抑制 SYSLIB1205 并不能解决该方法存在的所有权冲突。

受影响的 API