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

Example

public class Session
{
    // This code violates the rule.
    public event EventHandler? BeforeClose;
    public event EventHandler? AfterClose;

    // This code satisfies the rule.
    public event EventHandler? Closing;
    public event EventHandler? Closed;
}

Quand supprimer les avertissements

Ne supprimez pas un avertissement de cette règle.