Benennungsregeln
Einhaltung Support Namenskonvention der Namenskonventionen der .NET-Designrichtlinien.
In diesem Abschnitt
Regel | Beschreibung |
---|---|
CA1700: Enumerationswerte nicht mit "Reserviert" benennen. | Bei dieser Regel wird vorausgesetzt, dass Enumerationsmember mit einem Namen, der "reserved" enthält, derzeit nicht verwendet werden, sondern Platzhalter sind, die in einer künftigen Version umbenannt oder entfernt werden sollen. Das Umbenennen oder Entfernen eines Members ist eine unterbrechende Änderung. |
CA1707: Bezeichner sollten keine Unterstriche enthalten. | Bezeichnernamen dürfen keinen Unterstrich (_) enthalten. Namespaces, Typen, Member und Parameter werden von dieser Regel überprüft. |
CA1708: Bezeichner sollten sich nicht nur durch die Groß-/Kleinschreibung unterscheiden. | Bezeichner für Namespaces, Typen, Member und Parameter dürfen sich nicht nur durch die Groß-/Kleinschreibung unterscheiden, weil Sprachen, die auf die Common Language Runtime abzielen, nicht zwischen Groß- und Kleinschreibung unterscheiden müssen. |
CA1710: Bezeichner sollten ein richtiges Suffix aufweisen. | Die Typnamen, die bestimmte Basistypen erweitern oder bestimmte Schnittstellen implementieren, bzw. von diesen Typen abgeleitete Typen, weisen stets ein Suffix auf, das mit dem Basistyp oder der Schnittstelle verknüpft ist. |
CA1711: Bezeichner sollten kein falsches Suffix aufweisen. | 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. |
CA1712: Keine Typnamen als Präfixe für Enumerationswerte verwenden. | Den Namen von Enumerationsmembern wird der Typname nicht als Präfix vorangestellt, da die Typinformationen von den Entwicklungstools bereitgestellt werden sollten. |
CA1713: Ereignisse sollten kein Before- oder After-Präfix aufweisen. | Der Name eines Ereignisses beginnt mit "Before" oder "After". Um verwandte Ereignisse zu benennen, die in einer bestimmten Reihenfolge ausgelöst werden, verwenden Sie die Gegenwarts- oder Vergangenheitsform, um ihre relative Position in der Aktionsfolge anzugeben. |
CA1714: Flags-Enumerationen sollten Pluralnamen aufweisen. | Eine öffentliche Enumeration verfügt über das System.FlagsAttribute-Attribut, und der Name endet nicht in der Pluralform ("s"). Die Namen von mit FlagsAttribute markierten Typen stehen im Plural, da das Attribut angibt, dass mehr als ein Wert festgelegt werden kann. |
CA1715: Bezeichner sollten ein korrektes Präfix aufweisen. | Der Name einer extern sichtbaren Schnittstelle beginnt nicht mit einem großen "I". Der Name eines generischen Typparameters für einen extern sichtbaren Typ oder eine extern sichtbare Methode beginnt nicht mit einem großen "T". |
CA1716: Bezeichner sollten nicht mit Schlüsselwörtern übereinstimmen. | Ein Namespacename oder ein Typname stimmt mit einem reservierten Schlüsselwort in einer Programmiersprache überein. Bezeichner für Namespaces und Typen dürfen nicht mit Schlüsselwörtern übereinstimmen, die in Programmiersprachen für die Common Language Runtime definiert sind. |
CA1717: Nur FlagsAttribute-Enumerationen sollten Pluralnamen aufweisen. | Gemäß den Benennungskonventionen gibt ein Pluralname für eine Enumeration an, dass für die Enumeration mehrere Werte gleichzeitig angegeben werden können. |
CA1720: Bezeichner dürfen keine Typnamen enthalten. | Der Name eines Parameters in einem extern sichtbaren Member enthält einen Datentypnamen, oder der Name eines extern sichtbaren Members enthält einen sprachspezifischen Datentypnamen. |
CA1721: Eigenschaftennamen sollten nicht mit Get-Methoden übereinstimmen. | Der Name eines öffentlichen oder geschützten Members beginnt mit "Get" und stimmt in anderer Hinsicht mit dem Namen einer öffentlichen oder geschützten Eigenschaft überein. "Get"-Methoden und -Eigenschaften sollten Namen aufweisen, die ihre Funktionen deutlich erkennbar machen. |
CA1724: Typnamen sollten nicht mit Namespaces übereinstimmen. | Typnamen sollten nicht mit .NET-Namespaces übereinstimmen. Durch einen Verstoß gegen diese Regel kann die Verwendbarkeit der Bibliothek eingeschränkt werden. |
CA1725: Parameternamen sollten mit der Basisdeklaration übereinstimmen. | Die konsistente Benennung von Parametern in einer Überschreibungshierarchie erhöht die Verwendbarkeit von Methodenüberschreibungen. Ein Parametername in einer abgeleiteten Methode, der vom Namen in der Basisdeklaration abweicht, kann zu Unklarheiten dahingehend führen, ob es sich bei der Methode um eine Überschreibung der Basismethode oder eine neue Überladung der Methode handelt. |
CA1727: Verwenden von PascalCase für benannte Platzhalter | Verwenden Sie PascalCase für benannte Platzhalter in der Vorlage für Protokollierungsnachrichten. |
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.