CA1043: Dizin oluşturucular için tamsayı veya dize bağımsız değişkeni kullanın
Özellik | Değer |
---|---|
Kural Kimliği | CA1043 |
Başlık | Dizin oluşturucular için tam sayı veya dize bağımsız değişken kullanın |
Kategori | Tasarım |
Hataya neden olan veya bozulmayan düzeltme | Yeni |
.NET 8'de varsayılan olarak etkin | Hayır |
Neden
Tür, , System.Int64System.Objectveya System.Stringdışında System.Int32bir dizin türü kullanan bir dizin oluşturucu içerir.
Varsayılan olarak, bu kural yalnızca dışarıdan görünen türlere bakar, ancak bu yapılandırılabilir.
Kural açıklaması
Dizin oluşturucular, yani dizine alınan özellikler, dizin için tamsayı veya dize türlerini kullanmalıdır. Bu türler genellikle veri yapılarının dizinini oluşturmak ve kitaplığın kullanılabilirliğini artırmak için kullanılır. Türün Object kullanımı, belirli bir tamsayı veya dize türünün tasarım zamanında belirtilemediği durumlarla sınırlandırılmalıdır. Tasarım dizin için başka türler gerektiriyorsa, türün mantıksal veri depolarını temsil edip etmediğini yeniden düşünün. Mantıksal veri depolarını temsil etmiyorsa bir yöntem kullanın.
İhlalleri düzeltme
Bu kuralın ihlalini düzeltmek için dizini tamsayı veya dize türüyle değiştirin veya dizin oluşturucu yerine bir yöntem kullanın.
Uyarıların ne zaman bastırılması gerekiyor?
Yalnızca standart olmayan dizin oluşturucu gereksinimini dikkatle değerlendirdikten sonra bu kuraldan gelen bir uyarıyı bastırın.
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 CA1043
// The code that's violating the rule is on this line.
#pragma warning restore CA1043
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.CA1043.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.
Çözümlemek için kod yapılandırma
Bu kuralın kod tabanınızın hangi bölümlerinde çalıştırılacaklarını yapılandırmak için aşağıdaki seçeneği kullanın.
Bu seçeneği yalnızca bu kural, geçerli olduğu tüm kurallar veya bu kategorideki (Tasarım) tüm kurallar için yapılandırabilirsiniz. Daha fazla bilgi için bkz . Kod kalitesi kuralı yapılandırma seçenekleri.
Belirli API yüzeylerini ekleme
Bu kuralın üzerinde çalıştırılacak kod tabanınızın hangi bölümlerini erişilebilirliklerine göre yapılandırabilirsiniz. Örneğin, kuralın yalnızca genel olmayan API yüzeyinde çalıştırılması gerektiğini belirtmek için projenizdeki bir .editorconfig dosyasına aşağıdaki anahtar-değer çiftini ekleyin:
dotnet_code_quality.CAXXXX.api_surface = private, internal
Örnek
Aşağıdaki örnekte, dizin kullanan bir dizin oluşturucu gösterilmektedir Int32 .
string[] Month = new string[] { "Jan", "Feb", "..." };
public string this[int index]
{
get => Month[index];
}
Private month() As String = {"Jan", "Feb", "..."}
Default ReadOnly Property Item(index As Integer) As String
Get
Return month(index)
End Get
End Property