Megosztás a következőn keresztül:

Gyűjteménykifejezés használata üres (IDE0301)

  • Cikk
Tulajdonság Érték
Szabályazonosító IDE0301
Cím Gyűjteménykifejezés használata üresen
Kategória Stílus
Alkategória Nyelvi szabályok (kifejezésszintű beállítások)
Alkalmazandó nyelvek C# 12+
Beállítások dotnet_style_prefer_collection_expression

Áttekintés

Ez a szabály olyan kódot keres, amely hasonló Array.Empty<T>() (egy metódushívás, amely üres gyűjteményt ad vissza) vagy ImmutableArray<T>.Empty (egy üres gyűjteményt visszaadó tulajdonság), és felajánlja, hogy lecseréli egy gyűjteménykifejezésre ([]).

Beállítások

A beállítások határozzák meg a szabály kényszerítéséhez használni kívánt viselkedést. A beállítások konfigurálásával kapcsolatos információkért tekintse meg az Option formátumot.

dotnet_style_prefer_collection_expression

Tulajdonság Érték Leírás
Beállítás neve dotnet_style_prefer_collection_expression
Beállításértékek true | when_types_exactly_match Inkább csak akkor használjon gyűjteménykifejezéseket, ha a típusok pontosan egyeznek, például int[] i = Array.Empty<int>();.
when_types_loosely_match
(.NET 9 és újabb verziók)*		 A gyűjteménykifejezéseket akkor is érdemes használni, ha például a típusok lazán egyeznek. IEnumerable<int> i = Array.Empty<int>(); A megcélzott típusnak meg kell egyeznie a jobb oldali típussal, vagy a következő típusok egyikének kell lennie: IEnumerable<T>, , , IList<T>, IReadOnlyCollection<T>IReadOnlyList<T>. ICollection<T>
false | never Letiltja a szabályt.
Alapértelmezett beállításérték true a .NET 8-ban
when_types_loosely_match .NET 9 és újabb verziókban

*Ha ezt a beállítást használja, a kód kijavítása megváltoztathatja a kód szemantikáját.

Példa

// Code with violations.
int[] i = Array.Empty<int>();
IEnumerable<int> j = Array.Empty<int>();
ReadOnlySpan<int> span = ReadOnlySpan<int>.Empty;

// Fixed code.
int[] i = [];
IEnumerable<int> j = [];
ReadOnlySpan<int> span = [];

Az alábbi kódrészlet egy egyéni típussal rendelkező példát mutat be.

public class Program
{
    public static void Main()
    {
        // IDE0301 violation.
        MyList<int> x = MyList<int>.Empty;

        // IDE0301 fixed code.
        MyList<int> x = [];
    }
}

class MyList<T> : IEnumerable<T>
{
    public static MyList<T> Empty { get; }

    public IEnumerator<T> GetEnumerator() => default;
    IEnumerator IEnumerable.GetEnumerator() => default;
}

Figyelmeztetés mellőzése

Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.

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

Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none a konfigurációs fájlban.

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

Az összes kódstílus-szabály letiltásához állítsa be a kategória Style súlyosságát none a konfigurációs fájlban.

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

További információ: Kódelemzési figyelmeztetések letiltása.

Lásd még