CA1855: Usar Span<T>.Clear() em vez de Span<T>.Fill()
Property | Valor |
---|---|
ID da regra | CA1855 |
Título | Use Span<T>.Clear() em vez de Span<T>.Fill() |
Categoria | Desempenho |
Correção interruptiva ou sem interrupção | Sem interrupção |
Habilitado por padrão no .NET 9 | Como sugestão |
Causa
Span<T>.Fill(T) é chamado para preencher os elementos de um intervalo com um valor padrão.
Descrição da regra
É mais eficiente chamar Span<T>.Clear() do que chamar Span<T>.Fill(T) para preencher os elementos do intervalo com um valor padrão.
Como corrigir violações
Substitua a chamada para Span<T>.Fill(T) por uma chamada para Span<T>.Clear().
Exemplo
O seguinte snippet de código mostra uma violação de CA1855:
void M(Span<byte> span)
{
span.Fill(0);
}
O seguinte snippet de código conserta a violação:
void M(Span<byte> span)
{
span.Clear();
}
Quando suprimir avisos
É seguro fechar esse aviso se o desempenho não é uma preocupação.
Suprimir um aviso
Para suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem a fim de desabilitar e, em seguida, reabilitar a regra.
#pragma warning disable CA1855
// The code that's violating the rule is on this line.
#pragma warning restore CA1855
Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none
no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.CA1855.severity = none
Para obter mais informações, confira Como suprimir avisos de análise de código.