Afficher en anglais

Partage via

Utiliser des initialiseurs ou des expressions de collection (IDE0028)

  • Article
Property Valeur
Identificateur de la règle IDE0028
Titre Utiliser des initialiseurs de collections
Catégorie Style
Sous-catégorie Règles de langage (préférences au niveau des expressions)
Langages applicables C# et Visual Basic
Options dotnet_style_collection_initializer
dotnet_style_prefer_collection_expression

Vue d'ensemble

Cette règle de style concerne l'utilisation d'initialiseurs de collection et, si vous utilisez C# 12 ou une version ultérieure, d'expressions de collection pour l'initialisation de collection.

Dans .NET 8 (C# 12) et les versions ultérieures, si vous avez défini l'option dotnet_style_prefer_collection_expression sur true, le correctif de code dans Visual Studio convertit votre code d'initialisation de collection pour utiliser une expression de collection (List<int> list = [1, 2, 3];). Dans Visual Basic et dans .NET 7 (C# 11) et les versions antérieures, le correctif de code convertit votre code pour utiliser un initialiseur de collection (List<int> list = new List<int> { 1, 2, 3 };).

Remarque

Si vous utilisez le correctif de code dans Visual Studio, la modification qu'elle propose peut avoir une sémantique différente dans certains cas. Par exemple, int[] x = new int[] { } est remplacé par int[] x = [];, qui a une sémantique légèrement différente : le compilateur utilise un singleton pour x au lieu de créer une nouvelle instance.

Options

Définissez les valeurs des options associées à cette règle pour spécifier si les initialiseurs de collection et les expressions de collection sont préférés lors de l'initialisation des collections.

Pour plus d’informations sur la configuration des options, consultez Format d’option.

dotnet_style_collection_initializer

Property Valeur Description
Nom de l’option dotnet_style_collection_initializer
Valeurs d’option true Préférez utiliser les initialiseurs de collection.
false Ne pas préférer les initialiseurs de collectio
Valeur d’option par défaut true

dotnet_style_prefer_collection_expression (C# uniquement)

Property Valeur Description
Nom de l’option dotnet_style_prefer_collection_expression
Valeurs d’option true Préférez utiliser des expressions de collection.
false Ne pas préférer les expressions de collection.
Valeur d’option par défaut true

Exemples

C# 
// IDE0028 violation.
List<int> list = new List<int>();
list.Add(1);
list.Add(2);
list.Add(3);

// Fixed code (with dotnet_style_prefer_collection_expression = true)
List<int> list = [1, 2, 3];

Supprimer un avertissement

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

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

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

ini 
[*.{cs,vb}]
dotnet_diagnostic.IDE0028.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.

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

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

Voir aussi