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

  • Makale
Ö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
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 8'de varsayılan olarak etkin Hayır

Neden

Bir kültür belirtilmeden veya String.ToLower() belirtilmeden bir çağrı yapılırString.ToUpper().

Kural açıklaması

veya ToLowerçağrılırken ToUpper geçerli kültüre örtük bağımlılıktan kaçınmak için 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 veya çağrısı ToLower(CultureInfo)ToUpper(CultureInfo)ToUpperInvariant()ToLowerInvariant()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?

Hiçbir zaman değişmeyecek olduğundan eminseniz, bu kuraldan gelen bir uyarıyı Thread.CurrentCulture gizlemeniz 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.