Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

GD0201: The name of the delegate must end with 'EventHandler'

Regel-ID	GD0201
Kategorie	Verwendung
Fix führt oder führt nicht zu Kompatibilitätsbruch	Kompatibilitätsbruch
Standardmäßig aktiviert	Ja

Ursache

Ein Delegate, das mit dem Attribut ``[Signal]'' annotiert ist, hat einen Namen, der nicht mit 'EventHandler' endet.

Regelbeschreibung

Godot-Quellcodegeneratoren erzeugen C#-Events unter Verwendung des Namens des Delegates, wobei das Suffix "EventHandler" entfernt wird. Das Hinzufügen des Suffixes 'EventHandler' an den Namen von Delegates, die in Events verwendet werden, ist eine .NET-Namenskonvention.

Die Verwendung eines Suffixes für den Delegate ermöglicht es dem generierten Event, den Namen ohne das Suffix zu verwenden, um einen Namenskonflikt zu vermeiden.

// This delegate is invalid since the name doesn't end with 'EventHandler'.
[Signal]
public void InvalidSignal();

// This delegate is valid since the name ends with 'EventHandler'.
[Signal]
public void ValidSignalEventHandler();

Werfen Sie einen Blick in die C#-Signale-Dokumentation für weitere Informationen über die Deklaration und Verwendung von Signalen.

Wie man Verstöße behebt

Um einen Verstoß gegen diese Regel zu beheben, fügen Sie 'EventHandler' am Ende des Delegate-Namens hinzu.

Wann man Warnungen unterdrücken sollte

Unterdrücken Sie nicht eine Warnung zu dieser Regel. Signal-Delegates ohne das Suffix werden vom Quellcodegenerator ignoriert, so dass das Signal nicht registriert wird.