CA2247: El argumento pasado al constructor TaskCompletionSource debe ser una enumeración TaskCreationOptions en lugar de TaskContinuationOptions

Propiedad	Valor
Identificador de la regla	CA2247
Título	El argumento pasado al constructor TaskCompletionSource debe ser una enumeración de TaskCreationOptions en lugar de una enumeración de TaskContinuationOptions
Categoría	Uso
La corrección interrumpe o no interrumpe	Sin interrupción
Habilitado de forma predeterminada en .NET 10	Como advertencia
Idiomas aplicables	C# y Visual Basic

Causa

Construir un System.Threading.Tasks.TaskCompletionSource con un valor del enum System.Threading.Tasks.TaskContinuationOptions en lugar de un valor del enum System.Threading.Tasks.TaskCreationOptions. Usar el método System.Object.ReferenceEquals para comprobar la igualdad de uno o varios tipos de valor.

Descripción de la regla

El tipo TaskCompletionSource tiene un constructor que acepta un valor de enumeración System.Threading.Tasks.TaskCreationOptions y otro constructor que acepta un Object. Si accidentalmente se pasa un valor de enumeración System.Threading.Tasks.TaskContinuationOptions en lugar de un valor de enumeración System.Threading.Tasks.TaskCreationOptions, se producirá una llamada al constructor basado en Object: se compilará y ejecutará, pero no tendrá el comportamiento previsto.

Cómo corregir infracciones

Para corregir la infracción, reemplace el valor de enumeración System.Threading.Tasks.TaskContinuationOptions por el valor de enumeración System.Threading.Tasks.TaskCreationOptions correspondiente.

// Violation
var tcs = new TaskCompletionSource<int>(TaskContinuationOptions.RunContinuationsAsynchronously);

// Fixed
var tcs = new TaskCompletionSource<int>(TaskCreationOptions.RunContinuationsAsynchronously);

Cuándo suprimir las advertencias

Una infracción de esta regla casi siempre resalta un error en el código de llamada, de modo que el código no se comportará del modo previsto por el desarrollador, con TaskCompletionSource omitiendo de forma eficaz la opción especificada. La única vez que es seguro suprimir la advertencia es si el desarrollador realmente tenía la intención de pasar un System.Threading.Tasks.TaskContinuationOptions encapsulado como argumento de estado del objeto a TaskCompletionSource.

Supresión de una advertencia

Si solo quiere suprimir una única infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

#pragma warning disable CA2247
// The code that's violating the rule is on this line.
#pragma warning restore CA2247

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

[*.{cs,vb}]
dotnet_diagnostic.CA2247.severity = none

Para deshabilitar esta categoría completa de reglas, establezca la gravedad de la categoría en none en el archivo de configuración.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none

Para obtener más información, vea Cómo suprimir las advertencias de análisis de código.

Consulte también

• Reglas de uso