CA1708: Tanımlayıcılar örnekten daha fazla farklı olmalıdır

Özellik	Değer
Kural Kimliği	CA1708
Başlık	Tanımlayıcılar yalnızca büyük-küçük harf farkıyla birbirinden ayrılmamalıdır.
Kategori	Adlandırma
Düzeltme bozucu ya da bozmayan olabilir	Son Dakika
.NET 10'da varsayılan olarak etkin	Hayır
Geçerli diller	C# ve Visual Basic

Neden

Küçük harfe dönüştürüldüğünde iki tür, üye, parametre veya tam nitelikli ad alanı adları tamamen aynı olur.

Varsayılan olarak, bu kural yalnızca dışarıdan görünen türlere, üyelere ve ad alanlarına bakar, ancak bu yapılandırılabilir.

Kural açıklaması

Ad alanları, türler, üyeler ve parametreler için tanımlayıcılar yalnızca büyük/küçük harf farkıyla farklı olamaz çünkü ortak dil çalışma zamanını hedefleyen dillerin büyük/küçük harf duyarlılığı olması gerekmez. Örneğin, Visual Basic yaygın olarak kullanılan büyük/küçük harfe duyarsız bir dildir.

İhlalleri düzeltme

Büyük/küçük harfe duyarlı olmayan bir şekilde diğer tanımlayıcılarla karşılaştırıldığında benzersiz bir ad seçin.

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

Bu kuraldan uyarıyı bastırmayın. Kitaplık .NET'teki tüm kullanılabilir dillerde kullanılamayabilir.

Kod çözümleme için konfigüre et

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.

• Belirli API yüzeylerini ekleme

Bu seçeneği yalnızca bu kural, geçerli olduğu tüm kurallar veya bu kategorideki (Adlandırma) 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

api_surface seçeneğini ayarlayarak, bu kuralın erişilebilirliği temelinde kod tabanınızın hangi bölümlerinde çalıştırılacaklarını 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

Not

XXXX CAXXXX bölümünü geçerli kuralın kimliğiyle değiştirin.

İhlal örneği

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

public class Class1
{
    protected string someName;
    public string SomeName => someName;
}

Aşağıdaki örnekte, ihlali düzeltmenin bir yolu gösterilmektedir

public class Class1
{
    protected string _someName;
    public string SomeName => _someName;
}