Préférences this et Me (IDE0003 et IDE0009)

Cet article décrit deux règles associées, IDE0003 et IDE0009.

Vue d’ensemble

Ces deux règles déterminent si vous préférez ou non utiliser les qualificateurs this (C#) et Me. (Visual Basic). Pour faire en sorte que les qualificateurs ne soient pas présents, définissez la gravité de IDE0003 sur avertissement ou erreur. Pour faire en sorte que les qualificateurs soient présents, définissez la gravité de IDE0009 sur avertissement ou erreur.

Par exemple, si vous préférez utiliser des qualificateurs pour les champs et les propriétés, mais pas pour les méthodes ou les événements, vous pouvez activer IDE0009 et définir les options dotnet_style_qualification_for_field et dotnet_style_qualification_for_property sur true. Toutefois, cette configuration ne marque pas les méthodes et les événements qui ont des qualificateurs this et Me. Pour faire également en sorte que les méthodes et les événements n’aient pas de qualificateurs, activez IDE0003.

Options

Les options associées de cette règle définissent les symboles auxquels cette préférence de style doit être appliquée, parmi les symboles suivants :

• Champs (dotnet_style_qualification_for_field)
• Propriétés (dotnet_style_qualification_for_property)
• Méthodes (dotnet_style_qualification_for_method)
• Événements (dotnet_style_qualification_for_event)

La valeur d’option true signifie que de préférence, le symbole de code doit être précédé de this. en C# et de Me. en Visual Basic. La valeur d’option false signifie que de préférence, l’élément de code ne doit pas être précédé de this. ou de Me..

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

dotnet_style_qualification_for_field

// dotnet_style_qualification_for_field = true
this.capacity = 0;

// dotnet_style_qualification_for_field = false
capacity = 0;

' dotnet_style_qualification_for_field = true
Me.capacity = 0

' dotnet_style_qualification_for_field = false
capacity = 0

dotnet_style_qualification_for_property

// dotnet_style_qualification_for_property = true
this.ID = 0;

// dotnet_style_qualification_for_property = false
ID = 0;

' dotnet_style_qualification_for_property = true
Me.ID = 0

' dotnet_style_qualification_for_property = false
ID = 0

dotnet_style_qualification_for_method

// dotnet_style_qualification_for_method = true
this.Display();

// dotnet_style_qualification_for_method = false
Display();

' dotnet_style_qualification_for_method = true
Me.Display()

' dotnet_style_qualification_for_method = false
Display()

dotnet_style_qualification_for_event

// dotnet_style_qualification_for_event = true
this.Elapsed += Handler;

// dotnet_style_qualification_for_event = false
Elapsed += Handler;

' dotnet_style_qualification_for_event = true
AddHandler Me.Elapsed, AddressOf Handler

' dotnet_style_qualification_for_event = false
AddHandler Elapsed, AddressOf Handler

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.

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

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.

[*.{cs,vb}]
dotnet_diagnostic.IDE0003.severity = none
dotnet_diagnostic.IDE0009.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 de l’analyse de code.

Voir aussi

• this (référence C#)
• Règles de langage de style de code
• Référence sur les règles de style de code