Partager via


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

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

Propriété Value
Identificateur de la règle IDE0003
Titre Supprimer this ou Me qualifier
Catégorie Style
Sous-catégorie Règles de langage (qualificateurs 'this.' et 'Me.')
Langages applicables C# et Visual Basic
Options dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event
Propriété Value
Identificateur de la règle IDE0009
Titre Ajouter this ou Me qualifier
Catégorie Style
Sous-catégorie Règles de langage (qualificateurs 'this.' et 'Me.')
Langages applicables C# et Visual Basic
Options dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event

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.

Remarque

Même si vous activez des règles de style de code sur la build, cette règle n’est pas activée. Elle s’affiche uniquement dans l’éditeur Visual Studio.

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 :

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

Propriété Valeur Description
Nom d'option dotnet_style_qualification_for_field
Valeurs d’option true Préférer que les champs soient précédés de this. en C# ou de Me. en Visual Basic
false Préférer que les champs ne soient pas précédés de this. ou de Me.
Valeur d’option par défaut false
// 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

Propriété Valeur Description
Nom d'option dotnet_style_qualification_for_property
Valeurs d’option true Préférer que les propriétés soient précédées de this. en C# ou de Me. en Visual Basic.
false Préférer que les propriétés ne soient pas précédées de this. ou de Me..
Valeur d’option par défaut false
// 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

Propriété Valeur Description
Nom d'option dotnet_style_qualification_for_method
Valeurs d’option true Préférer que les méthodes soient précédées de this. en C# ou de Me. en Visual Basic.
false Préférer que les méthodes ne soient pas précédées de this. ou de Me..
Valeur d’option par défaut false
// 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

Propriété Valeur Description
Nom d'option dotnet_style_qualification_for_event
Valeurs d’option true Préférer que les événements soient précédés de this. en C# ou de Me. en Visual Basic.
false Préférer que les événements ne soient pas précédés de this. ou de Me..
Valeur d’option par défaut false
// 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