CA1861: Argüman olarak sabit diziler (constant arrays) kullanmaktan kaçının

Özellik Değer
Kural Kimliği CA1861
Başlık Bağımsız değişken olarak sabit dizilerden kaçının
Kategori Performans
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
.NET 10'da varsayılan olarak etkin Öneri olarak
Geçerli diller C# ve Visual Basic

Neden

Sabit bir değişmez değer dizisi, normal çağırma veya uzantı yöntemi çağırma yoluyla bir yönteme geçirilir.

Kural açıklaması

Bağımsız değişken olarak verilen sabit diziler, tekrar tekrar çağrıldığında tekrar kullanılmaz, bu da her seferinde yeni bir dizi oluşturulduğunu gösterir. Gönderilen dizi çağrılan yöntem içinde değiştirilmezse, performansı artırmak için bir static readonly alana ayıklamayı göz önünde bulundurun.

Not

Çağrılan yöntem geçirilen diziyi değiştirirse veya yöntemin diziyi değiştirip değiştirmediğinden emin değilseniz, diziyi bir static readonly alana çıkarmayın. Bu, uyumluluk sorununa yol açabilecek bir değişiklik olabilir. Bu durumda bunun yerine uyarıyı bastırmak daha iyidir.

İhlalleri düzeltme

Geçirilen dizi çağrılan yöntem içinde değiştirilmediyse, sabit dizileri static readonly alanlarına ayıklayın.

Aşağıdaki örnekte kuralın ihlali gösterilmektedir:

// A method argument
string message = string.Join(" ", new[] { "Hello", "world!" });

' A method argument
Dim message As String = String.Join(" ", {"Hello", "world!"})

Aşağıdaki örnekte, bir argüman static readonly alana ayıklanarak bu kuralın ihlali nasıl düzeltilir gösterilmektedir.

private static readonly string[] array = new[] { "Hello" , "world!" };

private string GetMessage()
{
    return string.Join(" ", array);
}

Private Shared ReadOnly array As String() = {"Hello", "world!"}

Private Function GetMessage() As String
    Return String.Join(" ", array)
End Function

Şimdi, dizinin değeri çalışma zamanında değil derleme zamanında çözümlenir ve kod daha performanslı hale getirilir.

Uyarıların ne zaman bastırılması gerekiyor?

Aşağıdakiler durumunda bu kuralın ihlalini gizleme:

  • Çağırma yalnızca bir kez gerçekleştirilir.
  • Dizi, çağrılan yöntem içinde değiştirilebilir veya değiştirilip değiştirilmediğinden emin değilsiniz.
  • Her çağrı için sabit bir dizi oluşturmanın performans etkisiyle ilgilenmiyorsunuz.

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

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.CA1861.severity = none

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

  • Last updated on