Verwenden des UTF-8-Zeichenfolgenliterals (IDE0230)

Artikel
07/28/2023

Eigenschaft	Wert
Regel-ID	IDE0230
Titel	Verwenden des UTF-8-Zeichenfolgenliterals
Kategorie	Stil
Unterkategorie	Sprachregeln (Einstellungen auf Ausdrucksebene)
Gültige Sprachen	C# 11+
Optionen	`csharp_style_prefer_utf8_string_literals`

Übersicht

Diese Regel kennzeichnet die Verwendung eines Bytearrays (byte[]), bei dem stattdessen ein UTF-8-Zeichenfolgenliteral verwendet werden kann. Die Verwendung eines UTF-8-Zeichenfolgenliterals erhöht die Klarheit der Deklaration.

Optionen

Optionen geben das Verhalten an, das die Regel erzwingen soll. Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

csharp_style_prefer_utf8_string_literals

Eigenschaft	Wert	Beschreibung
Name der Option	csharp_style_prefer_utf8_string_literals
Optionswerte	`true`	Bevorzugen Sie UTF-8-Zeichenfolgenliterale gegenüber Bytearrays.
	`false`	Die Regel wird deaktiviert.
Standardoptionswert	`true`

Beispiel

// Code with violations.
ReadOnlySpan<byte> _ = new byte[] { 65, 66, 67 };

// Fixed code.
ReadOnlySpan<byte> _ = "ABC"u8;

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

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

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

Teilen über