CA1030 : Utiliser des événements lorsque cela est appropriéCA1030: Use events where appropriate

TypeNameTypeName UseEventsWhereAppropriateUseEventsWhereAppropriate
CheckIdCheckId CA1030CA1030
CategoryCategory Microsoft.DesignMicrosoft.Design
Modification avec ruptureBreaking Change Sans ruptureNon-breaking

CauseCause

Un nom de la méthode publique, protégée ou privée commence par l’une des opérations suivantes :A public, protected, or private method name begins with one of the following:

  • Composant additionnelAddOn

  • RemoveOnRemoveOn

  • IncendieFire

  • RaiseRaise

Description de la règleRule description

Cette règle détecte des méthodes qui présentent des noms qui ordinairement seraient utilisés pour des événements.This rule detects methods that have names that ordinarily would be used for events. Événements suivent le modèle de design observateur ou publier / abonner ; ils sont utilisés lorsqu’un changement d’état dans un objet doit être communiqué à d’autres objets.Events follow the Observer or Publish-Subscribe design pattern; they are used when a state change in one object must be communicated to other objects. Si une méthode est appelée en réponse à un changement d’état clairement définie, la méthode doit être appelée par un gestionnaire d’événements.If a method gets called in response to a clearly defined state change, the method should be invoked by an event handler. Les objets qui appellent la méthode doivent déclencher des événements au lieu d'appeler directement la méthode.Objects that call the method should raise events instead of calling the method directly.

Voici quelques exemples courants d’événements sont trouvent dans des applications d’interface utilisateur où une action de l’utilisateur comme un clic sur un bouton provoque un segment de code à exécuter.Some common examples of events are found in user interface applications where a user action such as clicking a button causes a segment of code to execute. Le modèle d’événement .NET Framework n’est pas limité aux interfaces utilisateur ; Il doit être utilisé partout où que vous devez communiquer l’état passe à un ou plusieurs objets.The .NET Framework event model is not limited to user interfaces; it should be used anywhere you must communicate state changes to one or more objects.

Comment corriger les violationsHow to fix violations

Si la méthode est appelée lorsque l’état d’un objet change, vous devez envisager de modifier la conception pour utiliser le modèle d’événement .NET Framework.If the method is called when the state of an object changes, you should consider changing the design to use the .NET Framework event model.

Quand supprimer les avertissementsWhen to suppress warnings

Supprimez un avertissement de cette règle si la méthode ne fonctionne pas avec le modèle d’événement .NET Framework.Suppress a warning from this rule if the method does not work with the .NET Framework event model.