Utiliser la vérification « is null » (IDE0041)

Article
02/10/2025

Propriété	Valeur
Identificateur de la règle	IDE0041
Titre	Utiliser la vérification « is null »
Catégorie	Style
sous-catégorie	Règles de langage (préférences au niveau de l’expression)
langues applicables	C# et Visual Basic
introduit la version	Visual Studio 2017
Options	`dotnet_style_prefer_is_null_check_over_reference_equality_method`

Aperçu

Cette règle de style concerne l’utilisation d’une vérification null avec des critères spéciaux par rapport à l’utilisation de l’opérateur d’égalité (==) ou de l’appel Object.ReferenceEquals(Object, Object).

Options

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

dotnet_style_prefer_is_null_check_over_reference_equality_method

Propriété	Valeur	Description
nom de l’option	dotnet_style_prefer_is_null_check_over_reference_equality_method
Valeurs d’option	`true`	Préférer la vérification `is null`
	`false`	Préférer la méthode d’égalité des références
valeur d’option par défaut	`true`

// dotnet_style_prefer_is_null_check_over_reference_equality_method = true
if (value is null)
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if (object.ReferenceEquals(value, null))
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if ((object)o == null)
    return;

' dotnet_style_prefer_is_null_check_over_reference_equality_method = true
If value Is Nothing
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If Object.ReferenceEquals(value, Nothing)
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If CType(value, Object) = Nothing
    Return
End If

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

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

règles de langage de style de code
Référence sur les règles de style de code

Partager via