CA1830: Preferir las sobrecargas de método Append e Insert con tipos estrictos en StringBuilder

Propiedad	Valor
Identificador de la regla	CA1830
Título	Se recomienda preferir las sobrecargas de los métodos Append e Insert fuertemente tipadas en StringBuilder
Categoría	Rendimiento
La corrección interrumpe o no interrumpe	Sin interrupción
Habilitado de forma predeterminada en .NET 10	Como sugerencia
Idiomas aplicables	C# y Visual Basic

Causa

Se llamó a un método StringBuilderAppend o Insert con un argumento que era el resultado de llamar a ToString en un tipo para el que el método Append o Insert tiene una sobrecarga dedicada.

Descripción de la regla

Append y Insert proporcionan sobrecargas para varios tipos más allá de String. Siempre que sea posible, prefiera las sobrecargas fuertemente tipificadas sobre el uso de ToString() y las sobrecargas basadas en cadenas.

Cómo corregir infracciones

Elimine el elemento ToString() innecesario de la invocación.

using System.Text;

class C
{
    int _value;

    // Violation
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value.ToString()).AppendLine();
    }

    // Fixed
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value).AppendLine();
    }
}

Cuándo suprimir las advertencias

Se puede suprimir una infracción de esta regla si no hay preocupación por el impacto en el rendimiento de las asignaciones de cadenas innecesarias.

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 CA1830
// The code that's violating the rule is on this line.
#pragma warning restore CA1830

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.CA1830.severity = none

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

Vea también

• Reglas de rendimiento