Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
| Nieruchomość | Wartość |
|---|---|
| Identyfikator reguły | IDE0306 |
| Tytuł | Użyj wyrażenia kolekcji do tworzenia nowych obiektów |
| Kategoria | Styl |
| Podkategorii | Reguły języka (preferencje na poziomie wyrażenia) |
| Odpowiednie języki | Język C# 12+ |
| Opcje | dotnet_style_prefer_collection_expression |
Przegląd
Ta reguła wskazuje miejsca, w których wyrażenie kolekcji z elementem spread (..) można wykorzystać do inicjowania listy zamiast new. Na przykład ta reguła oferuje uproszczenie kodu, takiego jak new List<...>(x) w formularzu wyrażenia kolekcji ([.. x]).
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 (preferencja stylu .NET do wyrażania się w kolekcjach)
| Nieruchomość | Wartość | Opis |
|---|---|---|
| nazwa opcji | dotnet_style_prefer_collection_expression (preferencja stylu .NET do wyrażania się w kolekcjach) | |
| 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 List<int> list = new List<int>() { 1, 2 };. |
when_types_loosely_match* |
Wolisz używać wyrażeń kolekcji nawet wtedy, gdy typy są luźno zgodne, na przykład IEnumerable<int> list = new List<int>() { 1, 2 };. 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łę. | |
| Wartość opcji domyślnej | when_types_loosely_match* |
*Gdy ta opcja jest używana, poprawka kodu może zmienić semantyka kodu.
Przykład
// Code with violation.
List<int> l1 = new List<int>(Enumerable.Range(1, 10));
List<int> m1 = new List<int>(new[] { 1, 2, 3 });
// Fixed code.
List<int> l1 = [.. Enumerable.Range(1, 10)];
List<int> m1 = [.. new[] { 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 IDE0306
// The code that's violating the rule is on this line.
#pragma warning restore IDE0306
Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.
[*.{cs,vb}]
dotnet_diagnostic.IDE0306.severity = none
Aby wyłączyć wszystkie reguły stylu kodu, ustaw stopień ważności kategorii Style na none w pliku konfiguracji .
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia dotyczące analizy kodu.
Zobacz też
- Zastosuj wyrażenie kolekcji dla tablicy (IDE0300)
- Użyj wyrażenia kolekcji do reprezentacji pustej kolekcji (IDE0301)
- Używanie wyrażenia kolekcji dla obiektu stackalloc (IDE0302)
-
Użyj wyrażenia kolekcji dla
Create()(IDE0303) - Używanie wyrażenia kolekcji dla konstruktora (IDE0304)
- Użyj wyrażenia kolekcji dla płynnej składni (IDE0305)