Generatorn för alternativvalidering rapporterar SYSLIB1205 för explicita Validate-implementeringar

Från och med .NET 11 identifierar alternativvalideringskällan en explicit implementering av IValidateOptions<TOptions>.Validate som en handskriven implementering. Den rapporterar feldiagnostiken SYSLIB1205 i stället för att generera en separat offentlig synkron Validate metod.

Version som introducerades

.NET 11

Tidigare beteende

Tidigare kände källgeneratorn inte igen en explicit implementering av Validate(String, TOptions) som en befintlig implementering. Det kan generera ytterligare en offentlig Validate metod, så gränssnittsanrop skulle använda den handskrivna implementeringen medan direkta anrop på den konkreta validatorn skulle använda den genererade metoden. De två anropssökvägarna kan ge olika valideringsresultat.

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

Nytt beteende

Från och med .NET 11 identifierar källgeneratorn den explicita implementeringen, rapporterar SYSLIB1205 och undertrycker synkron Validate-generering för den alternativmodellen.

Om validatorn även implementerar IAsyncValidateOptions<TOptions>förblir synkron och asynkron generering oberoende. Den handskrivna synkrona implementeringen genererar SYSLIB1205 och undertrycker genererad Validate, men generatorn kan fortfarande generera ValidateAsync.

Typ av kompatibilitetsbrytande ändring

Den här ändringen kan påverka källkompatibiliteten.

Orsak till ändringen

Det tidigare beteendet tillät gränssnittsanrop att använda handskriven validering medan direkta anrop använde separat genererad validering. Att identifiera explicita implementeringar förhindrar att genererad validering kringgås tyst och tar bort dessa avvikande valideringssökvägar. Mer information finns i dotnet/runtime#130263.

Välj en ägare för den synkrona Validate implementeringen.

Om du vill använda källgenererad validering behåll [OptionsValidator] och ta bort den handskrivna explicita implementeringen:

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

Om du vill hantera valideringen manuellt tar du bort [OptionsValidator] och implementerar den fullständiga validatorn själv:

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

Det finns ingen kompatibilitetsinställning. Att undertrycka SYSLIB1205 löser inte det motstridiga ägandet av metoden.

Berörda API:er