Verwenden des UTF-8-Zeichenfolgenliterals (IDE0230)

2025-02-12

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

Überblick

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 Option format.

csharp_style_prefer_utf8_string_literals

Eigentum	Wert	Beschreibung
Optionenname	csharp_style_prefer_utf8_string_literals
Optionswerte	`true`	Bevorzugen Sie UTF-8-Zeichenfolgenliterale gegenüber Bytearrays.
	`false`	Deaktiviert die Regel.
Standardoptionenwert	`true`

Beispiel

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

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

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut 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 Konfigurationsdateiauf none fest.

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

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie von Style auf none in der Konfigurationsdatei fest.

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

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.

Freigeben über