Utiliser l'expression de la collection pour le vide (IDE0301)

Propriété	Valeur
Identificateur de la règle	IDE0301
Titre	Utiliser l'expression de la collection pour le vide
Catégorie	Style
sous-catégorie	Règles de langage (préférences au niveau de l’expression)
langues applicables	C# 12+
Options	dotnet_style_prefer_collection_expression

Aperçu

Cette règle recherche du code similaire à Array.Empty<T>() (un appel de méthode qui retourne une collection vide) ou ImmutableArray<T>.Empty (propriété qui retourne une collection vide) et propose de la remplacer par une expression de collection ([]).

Paramètres

Les options spécifient le comportement que la règle doit appliquer. Pour plus d’informations sur la configuration des options, consultez format des options.

dotnet_style_prefer_collection_expression

Propriété	Valeur	Descriptif
nom de l’option	dotnet_style_prefer_collection_expression
Valeurs d’option	true | when_types_exactly_match	Préférez utiliser des expressions de collection uniquement lorsque les types correspondent exactement, par exemple, List<int> list = new List<int>() { 1, 2 };.
	when_types_loosely_match*	Préférez utiliser des expressions de collecte même lorsque les types correspondent approximativement, par exemple, IEnumerable<int> list = new List<int>() { 1, 2 };. Le type ciblé doit correspondre au type sur le côté droit ou être l’un des types suivants : IEnumerable<T>, ICollection<T>, IList<T>, IReadOnlyCollection<T>, IReadOnlyList<T>.
	false | never	Il désactive la règle.
valeur d’option par défaut	when_types_loosely_match*

*Lorsque cette option est utilisée, le correctif de code peut modifier la sémantique de votre code.

Exemple

// Code with violations.
int[] i = Array.Empty<int>();
IEnumerable<int> j = Array.Empty<int>();
ReadOnlySpan<int> span = ReadOnlySpan<int>.Empty;

// Fixed code.
int[] i = [];
IEnumerable<int> j = [];
ReadOnlySpan<int> span = [];

L’extrait de code suivant montre un exemple avec un type personnalisé.

public class Program
{
    public static void Main()
    {
        // IDE0301 violation.
        MyList<int> x = MyList<int>.Empty;

        // IDE0301 fixed code.
        MyList<int> x = [];
    }
}

class MyList<T> : IEnumerable<T>
{
    public static MyList<T> Empty { get; }

    public IEnumerator<T> GetEnumerator() => default;
    IEnumerator IEnumerable.GetEnumerator() => default;
}

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

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.IDE0301.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.

Voir aussi

• Utiliser une expression de collection pour un tableau (IDE0300)