Aracılığıyla paylaş

(IDE0303) için Create() koleksiyon ifadesini kullanma

Mülk Değer
Kural Kimliği IDE0303
Başlık Oluştur 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, koleksiyon oluşturma yöntemi (özniteliğini kullanarak) olarak belirlenen bir Create() yöntemin veya benzer bir yöntemin CollectionBuilderAttribute bir koleksiyonu başlatmak için kullanıldığı ve bunu bir koleksiyon ifadesiyle ([...]) değiştirmeyi teklif ettiği yerleri bayraklar.

Create() yöntemleri sabit koleksiyonlar için ortaktır, örneğin, ImmutableArray.Create(1, 2, 3).

Not

Bu kural, koleksiyon-ifade desenini kabul eden sabit API'lerin (örneğin, System.Collections.Immutable) daha yeni sürümlerini gerektirir.

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_stili_koleksiyon_ifadesini_tercih_et

Mülk Değer Açıklama
Seçenek adı dotnet_stili_koleksiyon_ifadesini_tercih_et
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. List<int> list = new List<int>() { 1, 2 };
when_types_loosely_match* Türler gevşek bir şekilde eşleştiğinde bile koleksiyon ifadelerini kullanmayı tercih edin, örneğin. IEnumerable<int> list = new List<int>() { 1, 2 }; 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 when_types_loosely_match*

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

Örnek

// Code with violations.
ImmutableArray<int> i = ImmutableArray.Create(1, 2, 3);
IEnumerable<int> j = ImmutableArray.Create(1, 2, 3);

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

Aşağıdaki kod parçacığı, CollectionBuilderAttribute ile ek açıklama eklenen özel bir tür içeren bir örnek göstermektedir.

public class Program
{
    public static void Main()
    {
        // IDE0303 violation.
        MyCollection<int> c = MyCollection.Create(1, 2, 3);

        // IDE0303 fixed code.
        MyCollection<int> c = [1, 2, 3];
    }
}

static partial class MyCollection
{
    public static MyCollection<T> Create<T>(System.ReadOnlySpan<T> values) => default;
    public static MyCollection<T> Create<T>(T t1, T t2, T t3) => default;
}

[CollectionBuilder(typeof(MyCollection), "Create")]
class MyCollection<T> : IEnumerable<T>
{
    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 IDE0303
// The code that's violating the rule is on this line.
#pragma warning restore IDE0303

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.IDE0303.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.

  • Last updated on