CA1830: Preferir las sobrecargas de método Append e Insert fuertemente tipadas en StringBuilder
| Propiedad | Value |
|---|---|
| Identificador de la regla | CA1830 |
| Título | Preferir las sobrecargas de método Append e Insert fuertemente tipadas en StringBuilder |
| Categoría | Rendimiento |
| La corrección es problemática o no problemática | Poco problemático |
| Habilitado de forma predeterminada en .NET 9 | Como sugerencia |
Causa
Se llamó a un método StringBuilder Append 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 tipadas sobre el uso de ToString() y la sobrecarga basada en cadena.
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 le preocupa 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.
