CA1855: Verwenden von Span<T>.Clear() anstelle von Span<T>.Fill()

Artikel
11/12/2024

Eigenschaft	Wert
Regel-ID	CA1855
Titel	Verwenden von Span<T>.Clear() anstelle von Span<T>.Fill()
Kategorie	Leistung
Fix führt oder führt nicht zur Unterbrechung	Nicht unterbrechend
Standardmäßig in .NET 9 aktiviert	Als Vorschlag

Ursache

Span<T>.Fill(T) wird aufgerufen, um die Elemente einer Spanne (span) mit einem Standardwert zu füllen.

Regelbeschreibung

Es ist effizienter, Span<T>.Clear() statt Span<T>.Fill(T) aufzurufen, um die Elemente des „span“-Elements mit einem Standardwert aufzufüllen.

Behandeln von Verstößen

Ersetzen Sie den Aufruf von Span<T>.Fill(T) durch einen Aufruf von Span<T>.Clear().

Beispiel

Der folgende Codeausschnitt zeigt eine Verletzung von CA1855:

void M(Span<byte> span)
{
    span.Fill(0);
}

Der folgende Codeausschnitt korrigiert die Verletzung:

void M(Span<byte> span)
{
    span.Clear();
}

Wann sollten Warnungen unterdrückt werden?

Es ist ungefährlich, diese Warnung zu unterdrücken, wenn die Leistung kein Problem ist.

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

#pragma warning disable CA1855
// The code that's violating the rule is on this line.
#pragma warning restore CA1855

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none fest.

[*.{cs,vb}]
dotnet_diagnostic.CA1855.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Freigeben über