CA1308: Zeichenfolgen in Großbuchstaben normalisieren.

  • Artikel
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 8 aktiviert Nein

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.

Siehe auch