CA1311: Geben Sie eine Kultur an oder verwenden Sie eine invariante Version

Eigenschaft	Wert
Regel-ID	CA1311
Titel	Geben Sie eine Kultur an oder verwenden Sie eine invariante Version
Kategorie	Globalisierung
Fix ist eine Breaking- oder Non-Breaking-Änderung	Nicht umbrechend
Standardmäßig in .NET 10 aktiviert	Nein
Anwendbare Sprachen	C# und Visual Basic

Ursache

Der Aufruf von String.ToUpper() oder String.ToLower() erfolgt ohne Angabe einer Kultur.

Regelbeschreibung

Geben Sie eine Kultur an, oder verwenden Sie eine invariante Kultur, um beim Aufrufen von ToUpper oder ToLower implizite Abhängigkeiten von der aktuellen Kultur zu vermeiden. Die Verwendung einer invarianten Kultur führt unabhängig von der Kultur einer Anwendung zu konsistenten Ergebnissen.

Behebung von Verstößen

Rufen Sie anstelle der parameterlosen Methoden String.ToUpper() oder String.ToLower() die Methoden ToUpper(CultureInfo), ToUpperInvariant(), ToLower(CultureInfo) oder ToLowerInvariant() auf.

Beispiel

Der folgende Codeschnipsel zeigt einen Verstoß gegen die Regel CA1311:

string s = "hello";
s = s.ToLower();

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

Der folgende Codeausschnitt korrigiert die Verletzung:

string s = "hello";
s = s.ToLowerInvariant();

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

Wann sollten Warnungen unterdrückt werden?

Sie können Warnungen von dieser Regel problemlos unterdrücken, wenn Sie sicher sind, dass sich Thread.CurrentCulture nie ändern wird.

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

#pragma warning disable CA1311
// The code that's violating the rule is on this line.
#pragma warning restore CA1311

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei none auf fest.

[*.{cs,vb}]
dotnet_diagnostic.CA1311.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch

• Durchführen kulturunabhängiger Schreibungsänderungen