Freigeben über

Sammlungsausdruck für „stackalloc“ verwenden (IDE0302)

Eigentum Wert
Regel-ID IDE0302
Titel Sammlungsausdruck für „stackalloc“ verwenden
Kategorie Stil
Unterkategorie Sprachregeln (Präferenzen auf Ausdrucksebene)
Anwendbare Sprachen C# 12+
Optionen dotnet_style_prefer_collection_expression

Überblick

Diese Regel ähnelt Sammlungsausdruck für Array verwenden (IDE0300) mit der Ausnahme, dass nach stackalloc anstelle von Arrays gesucht wird. Wie bei IDE0300 wird angeboten, den Code in einen Sammlungsausdruck zu konvertieren. Beispielsweise werden stackalloc int[] { ... } und stackalloc [] { ... } zu [...]vereinfacht.

Anmerkung

Diese Regel ist nur in .NET 8 und höheren Versionen verfügbar, in denen die Werte im Stapel beibehalten werden können.

Optionen

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

dotnet_style_prefer_collection_expression

Eigentum 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 List<int>() { 1, 2 };.
when_types_loosely_match* Bevorzugen Sie die Verwendung von Auflistungsausdrücken, selbst wenn die Typen nur lose übereinstimmen, z. B. IEnumerable<int> list = new List<int>() { 1, 2 };. 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 Deaktiviert die Regel.
Standardwert der Option when_types_loosely_match*

*Wenn diese Option verwendet wird, kann die Codekorrektur die Semantik Ihres Codes ändern.

Der when_types_loosely_match Wert für diese Regel IDE0302gilt nicht, wird hier jedoch zur Vollständigkeit der dotnet_style_prefer_collection_expression Option aufgeführt (die von mehreren Regeln gemeinsam verwendet wird). Der Standardwert ist effektiv true.

Beispiel

// Code with violations.
ReadOnlySpan<int> x = stackalloc int[] { 1, 2, 3 };

// Fixed code.
ReadOnlySpan<int> x = [1, 2, 3];

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

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

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

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

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

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

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.

Siehe auch