CA2247: El argumento pasado al constructor TaskCompletionSource debe ser una enumeración TaskCreationOptions en lugar de TaskContinuationOptions
| Propiedad | Value |
|---|---|
| Identificador de la regla | CA2247 |
| Título | El argumento pasado al constructor TaskCompletionSource debe ser una enumeración TaskCreationOptions en lugar de TaskContinuationOptions |
| Categoría | Uso |
| La corrección es problemática o no problemática | Poco problemático |
| Habilitado de forma predeterminada en .NET 8 | Como advertencia |
Causa
Construir un System.Threading.Tasks.TaskCompletionSource con un valor de enumeración System.Threading.Tasks.TaskContinuationOptions en lugar de un valor de enumeración 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 quería pasar System.Threading.Tasks.TaskContinuationOptions con conversión boxing aplicada 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 Supresión de infracciones de análisis de código.
