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

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