Utiliser la chaîne littérale UTF-8 (IDE0230)

Article
02/12/2025

Propriété	Valeur
Identificateur de la règle	IDE0230
Titre	Utiliser le littéral de chaîne UTF-8
Catégorie	Style
sous-catégorie	Règles de langage (préférences au niveau de l’expression)
langues applicables	C# 11+
Options	`csharp_style_prefer_utf8_string_literals`

Aperçu

Cette règle indique l'utilisation d'un tableau d'octets (byte[]) alors qu'un littéral de chaîne UTF-8 pourrait être utilisé à la place. L'utilisation d'un littéral de chaîne UTF-8 ajoute de la clarté à la déclaration.

Options

Les options spécifient le comportement que vous souhaitez faire respecter par la règle. Pour plus d’informations sur la configuration des options, consultez le format d’option .

csharp_style_prefer_utf8_string_literals

Propriété	Valeur	Description
nom de l’option	csharp_style_prefer_utf8_string_literals
Valeurs d’option	`true`	Préférez les littéraux de chaîne UTF-8 aux tableaux d'octets.
	`false`	Il désactive la règle.
valeur d’option par défaut	`true`

Exemple

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

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

Supprimer un avertissement

Si vous souhaitez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver, puis réactivez la règle.

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

Pour désactiver la règle d’un fichier, d’un dossier ou d’un projet, définissez sa gravité sur none dans le fichier de configuration .

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

Pour désactiver toutes les règles de style de code, définissez la gravité de la catégorie Style sur none dans le fichier de configuration .

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

Pour plus d’informations, consultez Comment supprimer les avertissements d’analyse du code.

Partager via