Använda insamlingsinitierare eller uttryck (IDE0028)

Artikel
12/18/2024

Egenskap	Värde
regel-ID	IDE0028
rubrik	Använda insamlingsinitierare
kategori	Stil
underkategori	Språkregler (inställningar på uttrycksnivå)
Tillämpliga språk	C# och Visual Basic
alternativ	`dotnet_style_collection_initializer`
	`dotnet_style_prefer_collection_expression`

Överblick

Den här formatregeln gäller användningen av insamlingsinitierare och om du använder C# 12 eller senare samlingsuttryck för insamlingsinitiering.

I .NET 8 (C# 12) och senare versioner konverterar kodkorrigeringen i Visual Studio din initieringskod för att använda ett samlingsuttryck (List<int> list = [1, 2, 3];) om du har angett dotnet_style_prefer_collection_expression alternativet true. I Visual Basic och i .NET 7 (C# 11) och tidigare versioner konverterar -kodkorrigeringen koden till att använda en insamlingsinitierare (List<int> list = new List<int> { 1, 2, 3 };).

Not

Om du använder kodkorrigering i Visual Studio kan ändringen den erbjuder ha olika semantik i vissa fall. Till exempel ersätts int[] x = new int[] { } med int[] x = [];, som har något olika semantik – kompilatorn använder en singleton för x i stället för att skapa en ny instans.

Alternativ

Ange värdena för de associerade alternativen för den här regeln för att ange om insamlingsinitierare och samlingsuttryck ska föredras vid initiering av samlingar.

Mer information om hur du konfigurerar alternativ finns i Alternativformat.

dotnet_style_collection_initializer

Egenskap	Värde	Beskrivning
Alternativnamn	dotnet_style_collection_initializer
Alternativvärden	`true`	Föredrar att använda insamlingsinitierare.
	`false`	Föredrar inte insamlingsinitierare.
standardalternativvärde	`true`

dotnet_style_prefer_collection_expression (endast C#)

Egenskap	Värde	Beskrivning
Alternativnamn	dotnet_style_prefer_collection_expression
Alternativvärden	`true`	Föredrar att använda samlingsuttryck.
	`false`	Föredrar inte samlingsuttryck.
standardalternativvärde	`true`

Exempel

// IDE0028 violation.
List<int> list = new List<int>();
list.Add(1);
list.Add(2);
list.Add(3);

// Fixed code (with dotnet_style_prefer_collection_expression = true)
List<int> list = [1, 2, 3];

' IDE0028 violation.
Dim list = New List(Of Integer)
list.Add(1)
list.Add(2)
list.Add(3)

' Fixed code.
Dim list = New List(Of Integer) From {1, 2, 3}

Ignorera en varning

Om du bara vill förhindra en enda överträdelse lägger du till förprocessordirektiv i källfilen för att inaktivera och återaktiverar sedan regeln.

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

Om du vill inaktivera regeln för en fil, mapp eller ett projekt anger du dess allvarlighetsgrad till none i konfigurationsfilen.

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

Om du vill inaktivera alla regler i kodformat anger du allvarlighetsgraden för kategorin Style till none i konfigurationsfilen .

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

Mer information finns i Så här utelämnar du kodanalysvarningar.

Dela via