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