Bei Bezeichnern sollte die Groß-/Kleinschreibung beachtet werden
Aktualisiert: November 2007
TypeName |
IdentifiersShouldBeCasedCorrectly |
CheckId |
CA1709 |
Kategorie |
Microsoft.Naming |
Unterbrechende Änderung |
Unterbrechend – Wenn für Assemblys, Namespaces, Typen, Member und Parameter ausgelöst. Nicht unterbrechend – Wenn für generische Typparameter ausgelöst. |
Ursache
Der Name eines Bezeichners verfügt nicht über die richtige Groß-/Kleinschreibung.
- oder -
Der Name eines Bezeichners enthält ein Akronym aus zwei Buchstaben, und der zweite Buchstabe ist kleingeschrieben.
- oder -
Der Name eines Bezeichners enthält ein Akronym mit drei oder mehr Großbuchstaben.
Regelbeschreibung
Durch Benennungskonventionen erhalten Bibliotheken, die auf die Common Language Runtime ausgerichtet sind, 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.
Gemäß der Konvention werden Parameternamen in Kamel-Schreibweise verfasst. Für Namespace-, Typ- und Membernamen wird die Pascal-Schreibweise verwendet. In Namen in Kamel-Schreibweise ist der erste Buchstabe ein Kleinbuchstabe, und jedes weitere Wort im Namen fängt mit einem Großbuchstaben an. Beispiele für Namen in Kamel-Schreibweise sind "packetSniffer", "ioFile" und "fatalErrorCode". In Namen in der Pascal-Schreibweise ist der erste Buchstabe ein Großbuchstabe, und jedes weitere Wort im Namen fängt mit einem Großbuchstaben an. Beispiele für Namen in Pascal-Schreibweise sind "PacketSniffer", "IOFile" und "FatalErrorCode".
Während der Überprüfung dieser Regel wird der Name auf der Grundlage der Groß-/Kleinschreibung in Wörter aufgeteilt, und alle aus zwei Buchstaben bestehenden Wörter werden mit einer Liste häufig gebrauchter Wörter, die aus zwei Buchstaben bestehen, verglichen, z. B. "In" oder "My". Wird keine Übereinstimmung gefunden, wird angenommen, dass es sich bei dem Wort um ein Akronym handelt. Bei dieser Regel wird davon ausgegangen, dass ein Akronym gefunden wurde, wenn der Name vier Großbuchstaben nacheinander bzw. am Ende des Namens drei Großbuchstaben nacheinander enthält.
Aus zwei Buchstaben bestehende Akronyme umfassen in der Regel nur Großbuchstaben, bei Akronymen mit drei oder mehr Zeichen wird die Pascal-Schreibweise verwendet. Die folgenden Beispiele entsprechen dieser Namenskonvention: "DB", "CR", "Cpa" und "Ecma". Die folgenden Beispiele verstoßen gegen die Konvention: "Io", "XML" und "DoD" sowie "xp" und "cpl" für Namen, bei denen es sich nicht um Parameternamen handelt.
"ID" weist eine spezielle Schreibweise auf, um einen Verstoß gegen diese Regel zu verursachen. "Id" ist kein Akronym, sondern eine Abkürzung für "Identifikation". Das Abkürzung 'OK' ist ein anderer Sonderfall, der einen Verstoß gegen diese Regel verursacht. Okay sollte als 'Ok' abgekürzt werden, um Verstöße gegen diese Regel zu vermeiden.
Behandlung von Verstößen
Ändern Sie den Namen, sodass er die ordnungsgemäße Groß-/Kleinschreibung aufweist.
Wann sollten Warnungen unterdrückt werden?
Sie können diese Warnung gefahrlos unterdrücken, wenn Sie eigene Namenskonventionen verwenden oder wenn der Bezeichner einen Eigennamen darstellt, z. B. den Namen eines Unternehmens oder einer Technologie.
Verwandte Regeln
Bezeichner sollten sich nicht nur durch die Groß-/Kleinschreibung unterscheiden