(IDE0303) için Create()
koleksiyon ifadesini kullanma
Özellik | 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_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. ImmutableArray<int> i = ImmutableArray.Create(1, 2, 3); |
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 = ImmutableArray.Create(1, 2, 3); 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 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ığında, ile CollectionBuilderAttributeek açıklama eklenen özel türe sahip bir örnek gösterilmektedir.
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 none
olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.IDE0303.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.