Aracılığıyla paylaş

CA1861: Bağımsız değişken olarak sabit dizilerden kaçının

  • Makale
Özellik Değer
Kural Kimliği CA1861
Başlık Bağımsız değişken olarak sabit dizilerden kaçının
Kategori Performans
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 8'de varsayılan olarak etkin Öneri olarak

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 geçirilen sabit diziler art arda çağrıldığında yeniden kullanılmaz, bu da her seferinde yeni bir dizi oluşturulduğunu gösterir. Geçirilen dizi çağrılan yöntem içinde sessize alınmazsa, performansı artırmak için bir static readonly alana ayıklamayı göz önünde bulundurun.

Dekont

Çağrılan yöntem geçirilen diziyi sessize alırsa veya yöntemin diziyi sessize almadığından emin değilseniz, diziyi bir static readonly alana ayıklamayın. Bunu yapmak hataya neden olabilir. Bu durumda bunun yerine uyarıyı bastırmak daha iyidir.

İhlalleri düzeltme

Geçirilen dizi çağrılan yöntem içinde sessize alınmadıysa, alanlara sabit dizileri static readonly 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, bağımsız değişken bir static readonly alana ayıklanarak bu kuralın ihlalinin nasıl düzeltilmesi 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 bu da kodu daha performanslı hale getirir.

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

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

  • Çağırma yalnızca bir kez çalışır.
  • Dizi, çağrılan yöntem içinde kapatılabilir veya sessize alınıp alınmayacağını 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.