Boş (IDE0301) için koleksiyon ifadesi kullanma

  • Makale
Özellik Değer
Kural Kimliği IDE0301
Başlık Boş için koleksiyon ifadesini kullanma
Kategori Stil
Alt kategori Dil kuralları (ifade düzeyi tercihleri)
Geçerli diller C# 12+
Seçenekler dotnet_style_prefer_collection_expression

Genel bakış

Bu kural, (boş koleksiyon döndüren bir yöntem çağrısı) veya ImmutableArray<T>.Empty (boş koleksiyon döndüren bir özellik) gibi Array.Empty<T>() bir kod arar ve bunu bir koleksiyon ifadesiyle ([]) değiştirmeyi teklif eder.

Seçenekler

Seçenekler, kuralın zorlamasını istediğiniz davranışı belirtir. Seçenekleri yapılandırma hakkında bilgi için bkz . Seçenek biçimi.

dotnet_style_prefer_collection_expression

Özellik Değer Açıklama
Seçenek adı dotnet_style_prefer_collection_expression
Seçenek değerleri true | when_types_exactly_match Koleksiyon ifadelerini yalnızca türler tam olarak eşleştiğinde kullanmayı tercih eder, örneğin. int[] i = Array.Empty<int>();
when_types_loosely_match
(.NET 9 ve sonraki sürümleri)*		 Türler gevşek bir şekilde eşleştiğinde bile koleksiyon ifadelerini kullanmayı tercih edin, örneğin. IEnumerable<int> i = Array.Empty<int>(); Hedeflenen türün sağ taraftaki türle eşleşmesi veya şu türlerden biri olması gerekir: IEnumerable<T>, ICollection<T>, IList<T>, IReadOnlyCollection<T>, . IReadOnlyList<T>
false | never Kuralı devre dışı bırakır.
Varsayılan seçenek değeri true .NET 8'de
when_types_loosely_match .NET 9 ve sonraki sürümlerde

*Bu seçenek kullanıldığında kod düzeltmesi kodunuzun semantiğini değiştirebilir.

Örnek

// 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 = [];

Aşağıdaki kod parçacığında özel türe sahip bir örnek gösterilmektedir.

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;
}

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

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

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

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

Kod stili kuralların tümünü devre dışı bırakmak için, kategorinin Stylenoneönem derecesini yapılandırma dosyasında olarak ayarlayın.

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

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.