CA2263: Preferir sobrecarga genérica cuando se conoce el tipo
| Valor | |
|---|---|
| Identificador de la regla | CA2263 |
| Título | Preferir sobrecarga genérica cuando se conoce el tipo |
| Categoría | Uso |
| La corrección es problemática o no problemática | Poco problemático |
| Habilitado de forma predeterminada en .NET 9 | Como sugerencia |
Causa
Se llama a una sobrecarga de método que acepta un System.Type argumento cuando se conoce el tipo en tiempo de compilación y está disponible una sobrecarga genérica adecuada.
Descripción de la regla
Las sobrecargas genéricas son preferibles a las sobrecargas que aceptan un argumento de tipo System.Type cuando se conoce el tipo en tiempo de compilación (mediante el operador typeof en C# o el operador GetType en Visual Basic). Las sobrecargas genéricas promueven código más limpio y seguro para tipos con comprobaciones mejoradas en tiempo de compilación.
Cómo corregir infracciones
Para corregir una infracción de esta regla, use la sobrecarga genérica adecuada.
Ejemplo
El fragmento de código siguiente muestra una infracción de CA2263:
int size = Marshal.SizeOf(typeof(bool));
Dim size As Integer = Marshal.SizeOf(GetType(Boolean))
El siguiente fragmento de código corrige la infracción:
int size = Marshal.SizeOf<bool>();
Dim size As Integer = Marshal.SizeOf(Of Boolean)()
Cuándo suprimir las advertencias
Es seguro suprimir una advertencia de esta regla; sin embargo, se recomienda usar una sobrecarga genérica si es posible.
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 CA2263
// The code that's violating the rule is on this line.
#pragma warning restore CA2263
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.CA2263.severity = none
Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.
