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

Nom d’une 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. Les é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.

Des exemples courants d’événements sont trouvent dans les applications d’interface utilisateur où une action de l’utilisateur en cliquant 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 .NET Framework.NET Framework modèle d’événement n’est pas limité aux interfaces utilisateur ; il doit être utilisé partout où vous devez communiquer l’état passe à un ou plusieurs objets.The .NET Framework.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 .NET Framework.NET Framework modèle d’événement.If the method is called when the state of an object changes, you should consider changing the design to use the .NET Framework.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 .NET Framework.NET Framework modèle d’événement.Suppress a warning from this rule if the method does not work with the .NET Framework.NET Framework event model.