CA1308: Zeichenfolgen in Großbuchstaben normalisieren.
| Eigenschaft | Wert |
|---|---|
| Regel-ID | CA1308 |
| Titel | Zeichenfolgen in Großbuchstaben normalisieren. |
| Kategorie | Globalisierung |
| Fix führt oder führt nicht zur Unterbrechung | Nicht unterbrechend |
| Standardmäßig in .NET 9 aktiviert | No |
Ursache
Ein Vorgang normalisiert eine Zeichenfolge in Kleinbuchstaben.
Regelbeschreibung
Zeichenfolgen sollten in Großschreibung normalisiert werden. Für eine kleine Gruppe von Zeichen wird bei der Konvertierung in Kleinbuchstaben kein Roundtrip ausgeführt. Ein Roundtrip bedeutet, dass die Zeichen von einem Gebietsschema in ein anderes Gebietsschema konvertiert werden sollen, das Zeichendaten unterschiedlich darstellt, und dann die ursprünglichen Zeichen aus den konvertierten Zeichen genau abzurufen.
Behandeln von Verstößen
Änderungsvorgänge, bei denen Zeichenfolgen in Kleinbuchstaben konvertiert werden, sodass die Zeichenfolgen stattdessen in Großbuchstaben konvertiert werden. Sie können z. B. String.ToLower(CultureInfo.InvariantCulture) in String.ToUpper(CultureInfo.InvariantCulture) ändern.
Wann sollten Warnungen unterdrückt werden?
Es ist sicher, eine Warnung zu unterdrücken, wenn Sie keine Sicherheitsentscheidungen basierend auf dem Ergebnis der Normalisierung treffen (z. b. wenn Sie das Ergebnis in der Benutzeroberfläche anzeigen).
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 CA1308
// The code that's violating the rule is on this line.
#pragma warning restore CA1308
Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none fest.
[*.{cs,vb}]
dotnet_diagnostic.CA1308.severity = none
Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.
