CA1830: Prefira sobrecargas de método Append e Insert fortemente tipadas no StringBuilder
| Property | valor |
|---|---|
| ID da regra | CA1830 |
| Título | Prefira sobrecargas de método Append e Insert fortemente tipadas no StringBuilder |
| Categoria | Desempenho |
| A correção está quebrando ou não quebrando | Sem quebra |
| Habilitado por padrão no .NET 8 | Como sugestão |
Motivo
Um StringBuilder Append método ou Insert foi chamado com um argumento que era o resultado de chamar ToString um tipo para o qual o Append método ou Insert tem uma sobrecarga dedicada.
Descrição da regra
Append e Insert fornecer sobrecargas para vários tipos além do String. Quando possível, prefira as sobrecargas fortemente tipadas em vez de usar ToString() e a sobrecarga baseada em cadeia de caracteres.
Como corrigir violações
Elimine o desnecessário ToString() da invocação.
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();
}
}
Quando suprimir avisos
É seguro suprimir uma violação dessa regra se você não estiver preocupado com o impacto no desempenho de alocações de cadeia de caracteres desnecessárias.
Suprimir um aviso
Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.
#pragma warning disable CA1830
// The code that's violating the rule is on this line.
#pragma warning restore CA1830
Para desabilitar a regra de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.CA1830.severity = none
Para obter mais informações, consulte Como suprimir avisos de análise de código.
