Compartilhar via


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.