CA1860: Vermeiden der Verwendung der Erweiterungsmethode „Enumerable.Any()“
Eigenschaft | Wert |
---|---|
Regel-ID | CA1860 |
Titel | Vermeiden der Verwendung der Erweiterungsmethode „Enumerable.Any()“ |
Kategorie | Leistung |
Fix führt oder führt nicht zur Unterbrechung | Nicht unterbrechend |
Standardmäßig in .NET 8 aktiviert | Als Vorschlag |
Ursache
Enumerable.Any wird für einen Typ aufgerufen, der ein Length
, Count
oder IsEmpty
eine Eigenschaft aufweist.
Regelbeschreibung
Um zu ermitteln, ob ein Sammlungstyp über Elemente verfügt, ist es effizienter und übersichtlicher, die Eigenschaften Length
, Count
oder IsEmpty
(falls möglich) zu verwenden als die Methode Enumerable.Any aufzurufen.
Any()
ist eine Erweiterungsmethode, die die sprachintegrierte Abfrage (Language Integrated Query, LINQ) verwendet. Es ist effizienter, sich auf die eigenen Eigenschaften der Sammlung zu verlassen, und es verdeutlicht auch die Absicht.
Hinweis
Diese Regel ähnelt CA1827: Count()/LongCount() nicht verwenden, wenn Any() verwendet werden kann. Diese Regel gilt jedoch für die Linq-MethodeCount()
, während diese Regel die Verwendung der Count
Eigenschaft vorschlägt.
Behandeln von Verstößen
Ersetzen Sie einen Aufruf von Any() durch einen Aufruf der Length
-, IsEmpty
- oder Count
-Eigenschaft der Sammlung.
Beispiel
Der folgende Codeschnipsel zeigt einen Verstoß gegen CA1860:
bool HasElements(string[] strings)
{
return strings.Any();
}
Function HasElements(strings As String()) As Boolean
Return strings.Any()
End Function
Der folgende Codeausschnitt korrigiert die Verletzung:
bool HasElements(string[] strings)
{
return strings.Length > 0;
}
Function HasElements(strings As String()) As Boolean
Return strings.Length > 0
End Function
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 CA1860
// The code that's violating the rule is on this line.
#pragma warning restore CA1860
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.CA1860.severity = none
Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.