Udostępnij za pośrednictwem

Używanie wyrażenia kolekcji dla tablicy (IDE0300)

  • Artykuł
Własność Wartość
Identyfikator reguły IDE0300
Tytuł Użyj wyrażenia kolekcji w tablicy
Kategoria Styl
podkategorii Reguły języka (preferencje na poziomie wyrażenia)
odpowiednie języki C# 12+
opcje dotnet_style_prefer_collection_expression

Przegląd

Ta reguła oznacza miejsca, w których wyrażenie kolekcji można użyć do zainicjowania tablicy. Na przykład ta reguła oferuje uproszczenie kodu, takiego jak new C[] { ... }, new[] { ... }i C[] c = { ... }, do formularza wyrażenia kolekcji ([...]).

Opcje

Opcje określają zachowanie, które ma być wymuszane przez regułę. Aby uzyskać informacje na temat konfigurowania opcji, zobacz Format opcji.

dotnet_style_prefer_collection_expression

Własność Wartość Opis
nazwa opcji dotnet_style_prefer_collection_expression
wartości opcji true | when_types_exactly_match Wolisz używać wyrażeń kolekcji tylko wtedy, gdy typy są dokładnie zgodne, na przykład int[] i = new int[] { 1, 2, 3 };.
when_types_loosely_match
(.NET 9 i nowsze wersje)*		 Wolisz używać wyrażeń kolekcji nawet wtedy, gdy typy są luźno zgodne, na przykład IEnumerable<int> i = new int[] { 1, 2, 3 };. Typ docelowy musi być zgodny z typem po prawej stronie lub być jednym z następujących typów: IEnumerable<T>, ICollection<T>, IList<T>, IReadOnlyCollection<T>, IReadOnlyList<T>.
false | never Wyłącza regułę.
domyślna wartość opcji true na platformie .NET 8
when_types_loosely_match na platformie .NET 9 i nowszych wersjach

*Poprawka kodu podczas używania tej opcji może zmienić semantykę twojego kodu. Jeśli na przykład miałbyś IEnumerable<int> x = new int[] { 1, 2, 3 };, to w oryginalnym kodzie zostanie utworzona tablica. Jednak w nowym kodzie (IEnumerable<int> x = [1, 2, 3];) zamiast tego tworzony jest typ wewnętrzny syntetyzowany przez kompilator. Tę różnicę można zaobserwować, jeśli wykorzystujesz is sprawdzenie lub rzutowanie.

Przykład

// Code with violations.
int[] i = new int[] { 1, 2, 3 };
IEnumerable<int> j = new int[] { 1, 2, 3 };

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

Pomijanie ostrzeżenia

Jeśli chcesz pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji .

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

Aby wyłączyć wszystkie reguły stylu kodu, ustaw poziom ważności dla kategorii Style na none w pliku konfiguracyjnym .

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia analizy kodu.

Zobacz też