Agregar conversión explícita (IDE0221)

Visión general

Esta regla marca los casts explícitos en el código fuente donde el compilador inserta un cast explícito oculto adicional. Las conversiones visibles y ocultas pueden producir errores en tiempo de ejecución por diferentes motivos. Cuando esta regla señala dicho código, recomienda añadir explícitamente el cast intermedio en la fuente para dejar clara la intención del código.

Por ejemplo, si escribes (Derived)x donde x es de un tipo que requiere dos conversiones explícitas—primero a un tipo base y luego al tipo derivado—solo se ve un cast en la fuente. El compilador inserta la conversión intermedia sin ninguna indicación en el origen. Esta regla sugiere escribir ambas conversiones explícitamente: (Derived)(Base)x.

Options

Las opciones especifican el comportamiento que desea que aplique la regla. Para obtener información sobre cómo configurar opciones, vea Formato de opción.

dotnet_style_prefer_non_hidden_explicit_cast_in_source

Ejemplo

class Base { }
class Derived : Base { }

class Castable
{
    public static explicit operator Base(Castable c) => new Base();
}

class C
{
    void M()
    {
        // Code with violation: the compiler inserts a hidden (Base) cast.
        var v = (Derived)new Castable();

        // Fixed code: both casts are explicit in source.
        var v2 = (Derived)(Base)new Castable();
    }
}

Supresión de una advertencia

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

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

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

[*.cs]
dotnet_diagnostic.IDE0221.severity = none

Para deshabilitar todas las reglas de estilo de código, establezca la gravedad de la categoría Style a none en el archivo de configuración.

[*.cs]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

Consulte también

• Agregar conversión explícita en el bucle foreach (IDE0220)
• Reglas del lenguaje de estilo de código
• Referencia de reglas de estilo de código