Freigeben über


CA1030: Nach Möglichkeit Ereignisse verwenden

TypeName

UseEventsWhereAppropriate

CheckId

CA1030

Kategorie

Microsoft.Design

Unterbrechende Änderung

Nicht unterbrechend

Ursache

Ein öffentlicher, geschützter oder privater Methodenname beginnt mit einer der folgenden Zeichenfolgen:

  • AddOn

  • RemoveOn

  • Fire

  • Raise

Regelbeschreibung

Diese Regel erkennt Methoden, deren Namen normalerweise für Ereignisse verwendet würden. Ereignisse entsprechen dem Entwurfsmuster Beobachter oder Veröffentlichen-Abonnieren. Sie werden benutzt, wenn andere Objekte über eine Zustandsänderung in einem Objekt informiert werden müssen. Wenn eine Methode auf eine klar definierte Zustandsänderung hin aufgerufen wird, sollte die Methode von einem Ereignishandler aufgerufen werden. Objekte, die die Methode aufrufen, sollten Ereignisse auslösen, statt die Methode direkt aufzurufen.

Einige gängige Beispiele für Ereignisse finden sich in Benutzeroberflächenanwendungen, in denen eine Benutzeraktion, z. B. das Klicken auf eine Schaltfläche, die Ausführung eines bestimmtes Codesegments bewirkt. Das Ereignismodell von .NET Framework ist nicht auf Benutzeroberflächen beschränkt. Es sollte überall dort verwendet werden, wo ein oder mehrere Objekte über Zustandsänderungen informiert werden müssen.

Behandeln von Verstößen

Wenn die Methode aufgerufen wird, sobald sich der Zustand eines Objekts ändert, sollten Sie in Erwägung ziehen, den Entwurf zu ändern und das Ereignismodell von .NET Framework zu verwenden.

Wann sollten Warnungen unterdrückt werden?

Unterdrücken Sie eine Warnung dieser Regel, wenn sich das Ereignismodell von .NET Framework nicht für die Methode eignet.