Oluşturucu için koleksiyon ifadesi kullanma (IDE0304)

Makale
02/07/2024

Özellik	Değer
Kural Kimliği	IDE0304
Başlık	Oluşturucu için 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, öğeleri ekleyen ve son olarak özniteliğine sahip bir koleksiyon türü (örneğin çağırarakImmutableArray<T>.Builder.ToImmutable()) oluşturan bir oluşturucu türü oluşturmak için bir veya benzer yöntemin CollectionBuilderAttribute çağrıldığı yerleri CreateBuilder() işaretler. Bunun yerine, koleksiyonu başlatmak için bir koleksiyon ifadesi ([...]) kullanılabilir.

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_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 edin.
	`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. 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 violation.
var builder = ImmutableArray.CreateBuilder<int>();
builder.Add(1);
builder.AddRange(new int[] { 5, 6, 7 });
ImmutableArray<int> i = builder.ToImmutable();

// Fixed code.
ImmutableArray<int> i = [1, .. new int[] { 5, 6, 7 }];

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 IDE0304
// The code that's violating the rule is on this line.
#pragma warning restore IDE0304

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

Aracılığıyla paylaş