CA1311: Bir kültür belirtin veya sabit bir sürüm kullanın

Özellik Değer
Kural Kimliği CA1311
Başlık Bir kültür belirtin veya sabit bir sürüm kullanın
Kategori Globalleştirme
Düzeltme bozucu veya bozucu olmayan bir etkisi olabilir Kaydırmaz
.NET 10'da varsayılan olarak etkin Hayır
Geçerli diller C# ve Visual Basic

Neden

Kültür belirtilmeden String.ToUpper() veya String.ToLower() için bir çağrı yapılır.

Kural açıklaması

Geçerli kültüre örtük bağımlılıktan kaçınmak için ToUpper veya ToLower çağırılırken bir kültür belirtin veya sabit bir kültür kullanın. Sabit bir kültür kullanmak, uygulamanın kültüründen bağımsız olarak tutarlı sonuçlar verir.

İhlalleri düzeltme

parametresiz String.ToUpper() veya String.ToLower() yöntemlerini çağırmak yerine, ToUpper(CultureInfo) veya ToUpperInvariant() ya da ToLower(CultureInfo) veya ToLowerInvariant() çağrılarından birini yapın.

Örnek

Aşağıdaki kod parçacığı ca1311 kuralı ihlalini gösterir:

string s = "hello";
s = s.ToLower();
Dim s As String = "hello"
s.ToLower()

Aşağıdaki kod parçacığı ihlali düzeltir:

string s = "hello";
s = s.ToLowerInvariant();
Dim s As String = "hello"
s.ToLowerInvariant()

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

Eğer Thread.CurrentCulture'nin asla değişmeyeceğinden eminseniz, bu kuraldan gelen uyarıyı bastırmanız güvenlidir.

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

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

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

Ayrıca bkz.