Sammlungsausdruck für „fluent“ verwenden (IDE0305)

Artikel
02/01/2024

Eigenschaft	Wert
Regel-ID	IDE0305
Titel	Sammlungsausdruck für „fluent“ verwenden
Kategorie	Stil
Unterkategorie	Sprachregeln (Einstellungen auf Ausdrucksebene)
Gültige Sprachen	C# 12+
Optionen	`dotnet_style_prefer_collection_expression`

Überblick

Diese Regel kennzeichnet Stellen, an denen eine Auflistung fließend (fluent) aufgebaut ist, d. h. Methoden wie Add(), AddRange(), AsSpan(), ToList() und ToArray() sind verkettet. Stattdessen könnte ein Sammlungsausdruck verwendet werden, um die Auflistung zu initialisieren. x.AddRange(y).Add(z).AsSpan() wird z. B. in [x, ..y, z] konvertiert.

Optionen

Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

dotnet_style_prefer_collection_expression

Eigenschaft	Wert	Beschreibung
Name der Option	dotnet_style_prefer_collection_expression
Optionswerte	`true` \| `when_types_exactly_match`	Verwenden Sie Auflistungsausdrücke nur, wenn Typen exakt übereinstimmen, z. B. `List<int> list = new[] { 1, 2, 3 }.ToList();`.
	`when_types_loosely_match` (.NET 9 und höhere Versionen)^*	Verwenden Sie Auflistungsausdrücke lieber auch dann, wenn Typen lose übereinstimmen, z. B. `IEnumerable<int> list = new[] { 1, 2, 3 }.ToList();`. Der Zieltyp muss mit dem Typ auf der rechten Seite übereinstimmen oder einer der folgenden Typen sein: IEnumerable<T>, ICollection<T>, IList<T>, IReadOnlyCollection<T>, IReadOnlyList<T>.
	`false` \| `never`	Die Regel wird deaktiviert.
Standardoptionswert	`true` in .NET 8 `when_types_loosely_match` in .NET 9 und höheren Versionen

^*Die Codekorrektur, wenn diese Option verwendet wird, kann die Semantik des Codes ändern.

Beispiel

// Code with violation.
List<int> i = new[] { 1, 2, 3 }.ToList();
IEnumerable<int> j = new[] { 1, 2, 3 }.ToList();

// Fixed code.
List<int> i = [1, 2, 3];
IEnumerable<int> j = [1, 2, 3];

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 IDE0305
// The code that's violating the rule is on this line.
#pragma warning restore IDE0305

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.IDE0305.severity = none

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

Freigeben über