Akıcı (IDE0305) için koleksiyon ifadesi kullanma
Özellik | Değer |
---|---|
Kural Kimliği | IDE0305 |
Başlık | Akıcı bir şekilde koleksiyon ifadesi 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, bir koleksiyonun akıcı bir şekilde oluşturulduğu, yani , AddRange()
, AsSpan()
, ToList()
ve ToArray()
gibi Add()
yöntemlerin zincirlendiği yerleri bayraklar. Bunun yerine, koleksiyonu başlatmak için bir koleksiyon ifadesi kullanılabilir. Örneğin, x.AddRange(y).Add(z).AsSpan()
öğesine [x, ..y, z]
dönüştürülür.
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. List<int> list = new[] { 1, 2, 3 }.ToList(); |
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> list = new[] { 1, 2, 3 }.ToList(); 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'dewhen_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 violation.
List<int> i = new[] { 1, 2, 3 }.ToList();
IEnumerable<int> j = new[] { 1, 2, 3 }.ToList();
// Fixed code.
List<int> i = [1, 2, 3];
IEnumerable<int> j = [1, 2, 3];
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 IDE0305
// The code that's violating the rule is on this line.
#pragma warning restore IDE0305
Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini none
olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.IDE0305.severity = none
Kod stili kuralların tümünü devre dışı bırakmak için, kategorinin Style
none
ö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.