Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
TypeName |
IdentifiersShouldNotHaveIncorrectSuffix |
CheckId |
CA1711 |
Kategorie (Category) |
Microsoft.Naming |
Unterbrechende Änderung |
Breaking |
Ursache
Ein Bezeichner weist ein falsches Suffix auf.
Regelbeschreibung
Nur die Namen von Typen, die bestimmte Basistypen erweitern oder bestimmte Schnittstellen bzw. Typen implementieren, die von diesen Typen abgeleitet werden, sollten stets mit bestimmten reservierten Suffixen enden.Für andere Typnamen sollten diese reservierten Suffixe nicht verwendet werden.
In der folgenden Tabelle werden die reservierten Suffixe sowie die Basistypen und die Schnittstellen aufgeführt, denen die Suffixe zugeordnet sind.
Suffix |
Basistyp/Schnittstelle |
|---|---|
Attribute |
|
Auflistung |
|
Dictionary |
|
EventArgs |
|
EventHandler |
Ein Ereignishandlerdelegat. |
Ausnahme |
|
Berechtigung |
|
Warteschlange |
|
Stapel |
|
Stream |
Außerdem sollten die folgenden Suffixe nicht verwendet werden:
Delegate
Enum
Impl – Verwenden Sie stattdessen 'Core'.
"Ex" oder ein ähnliches Suffix zur Unterscheidung von einer früheren Version desselben Typs
Durch Benennungskonventionen erhalten Bibliotheken, die auf die Common Language Runtime abzielen, ein einheitliches Erscheinungsbild.Dadurch wird der Lernaufwand für neue Softwarebibliotheken verringert. Zudem wird das Kundenvertrauen dahingehend gestärkt, dass die Bibliothek von einem erfahrenen Entwickler für verwalteten Code erstellt wurde.
Behandeln von Verstößen
Entfernen Sie das Suffix aus dem Typnamen.
Wann sollten Warnungen unterdrückt werden?
Unterdrücken Sie keine Warnung dieser Regel, es sei denn, das Suffix hat eine eindeutige Bedeutung in der Anwendungsdomäne.
Verwandte Regeln
CA1710: Bezeichner sollten ein richtiges Suffix aufweisen