CA1713 : Les événements ne doivent pas être munis d'un préfixe Before ou After
Propriété | Value |
---|---|
Identificateur de la règle | CA1713 |
Titre | Les événements ne doivent pas être munis d'un préfixe Before ou After |
Catégorie | Dénomination |
Le correctif est cassant ou non cassant | Rupture |
Activé par défaut dans .NET 8 | Non |
Cause
Le nom d’un événement commence par 'Before' ou 'After'.
Description de la règle
Les noms d’événements doivent décrire l’action qui déclenche l’événement. Pour nommer des événements associés déclenchés dans une séquence spécifique, utilisez le présent ou le passé pour indiquer la position relative dans la séquence d'actions. Par exemple, lorsque vous nommez une paire d’événements déclenchés lors de la fermeture d’une ressource, vous pouvez la nommer 'Closing' et 'Closed', au lieu de 'BeforeClose' et 'AfterClose'.
Les conventions de nommage fournissent une recherche commune pour les bibliothèques qui ciblent le common language runtime. Cette cohérence réduit la courbe d’apprentissage requise pour les nouvelles bibliothèques de logiciels et augmente la confiance des clients en ce qui concerne le développement de la bibliothèque par une personne qui a une expertise dans le développement de code managé.
Comment corriger les violations
Supprimez le préfixe du nom de l’événement, et envisagez de modifier le nom de façon à utiliser le temps présent ou passé d’un verbe.
Quand supprimer les avertissements
Ne supprimez pas un avertissement de cette règle.