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

  • Artículo
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.

Consulte también