Freigeben über


Konventionen für die Groß-/Kleinschreibung

Hinweis

Dieser Inhalt wird mit Genehmigung von Pearson Education, Inc. aus Framework Design Guidelines: Konventionen, Idiome und Muster für wiederverwendbare .NET-Bibliotheken, 2. Auflage nachgedruckt. Diese Ausgabe wurde 2008 veröffentlicht, und das Buch wurde seitdem in der dritten Ausgabe vollständig überarbeitet. Einige der Informationen auf dieser Seite sind möglicherweise veraltet.

Die Richtlinien in diesem Kapitel legen eine einfache Methode für die Verwendung der Groß-/Kleinschreibung dar, die bei konsistenter Anwendung Bezeichner für Typen, Member und Parameter leicht lesbar macht.

Großschreibungsregeln für Bezeichner

Um Wörter in einem Bezeichner zu unterscheiden, schreiben Sie den ersten Buchstaben jedes Worts im Bezeichner groß. Verwenden Sie keine Unterstriche, um Wörter zu unterscheiden oder überhaupt in Bezeichnern. Je nach Verwendung des Bezeichners gibt es zwei geeignete Methoden zur Großschreibung:

  • PascalCasing

  • camelCasing

Die PascalCasing-Konvention, die für alle Bezeichner außer Parameternamen verwendet wird, großgeschrieben das erste Zeichen jedes Worts (einschließlich Akronyme über zwei Buchstaben in der Länge), wie in den folgenden Beispielen gezeigt:

PropertyDescriptor HtmlTag

Ein Sonderfall wird für Zwei-Buchstaben-Akronyme erstellt, in denen beide Buchstaben großgeschrieben sind, wie im folgenden Bezeichner dargestellt:

IOStream

Die CamelCasing-Konvention, die nur für Parameternamen verwendet wird, schreibt das erste Zeichen jedes Wortes außer dem ersten Wort groß, wie in den folgenden Beispielen zu sehen ist. Wie das Beispiel auch zeigt, werden Akronyme, die aus zwei Buchstaben bestehen und den Anfang eines camelCase-Bezeichners darstellen, mit zwei Kleinbuchstaben geschrieben.

propertyDescriptor ioStream htmlTag

✔️ VERWENDEN Sie PascalCasing für alle öffentlichen Member-, Typ- und Namespacenamen, die aus mehreren Wörtern bestehen.

✔️ VERWENDEN Sie camelCasing für Parameternamen.

In der folgenden Tabelle werden die Groß-/Kleinschreibungsregeln für verschiedene Bezeichnertypen beschrieben.

Kennung Schreibweise Beispiel
Namespace Pascal namespace System.Security { ... }
Typ Pascal public class StreamReader { ... }
Schnittstelle Pascal public interface IEnumerable { ... }
Methode Pascal public class Object {
public virtual string ToString();
}
Eigentum Pascal public class String {
public int Length { get; }
}
Ereignis Pascal public class Process {
public event EventHandler Exited;
}
Feld Pascal public class MessageQueue {
public static readonly TimeSpan
InfiniteTimeout;
}
public struct UInt32 {
public const Min = 0;
}
Enumerationswert Pascal public enum FileMode {
Append,
...
}
Parameter Kamel public class Convert {
public static int ToInt32(string value);
}

Großschreibung zusammengesetzter Wörter und allgemeiner Begriffe

Die meisten zusammengesetzten Ausdrücke werden hinsichtlich der Großschreibung als Einzelwörter behandelt.

❌ Verwenden Sie keine Großbuchstaben für jedes Wort in sogenannten Zusammensetzungen mit geschlossener Form.

Dies sind zusammengesetzte Wörter, die als einzelnes Wort geschrieben werden, z. B. Endpunkt. Behandeln Sie ein Kompositum (zusammengesetztes Wort in geschlossener Form) hinsichtlich der Richtlinien für die Groß-/Kleinschreibung als einzelnes Wort. Verwenden Sie ein aktuelles Wörterbuch, um zu ermitteln, ob ein zusammengesetztes Wort in geschlossener Form geschrieben wird.

Pascal Kamel Nicht
BitFlag bitFlag Bitflag
Callback callback CallBack
Canceled canceled Cancelled
DoNot doNot Don't
Email email EMail
Endpoint endpoint EndPoint
FileName fileName Filename
Gridline gridline GridLine
Hashtable hashtable HashTable
Id id ID
Indexes indexes Indices
LogOff logOff LogOut
LogOn logOn LogIn
Metadata metadata MetaData, metaData
Multipanel multipanel MultiPanel
Multiview multiview MultiView
Namespace namespace NameSpace
Ok ok OK
Pi pi PI
Placeholder placeholder PlaceHolder
SignIn signIn SignOn
SignOut signOut SignOff
UserName userName Username
WhiteSpace whiteSpace Whitespace
Writable writable Writeable

Groß- und Kleinschreibung

Sprachen, die in der CLR ausgeführt werden können, müssen keine Unterstützung für Groß-/Kleinschreibung aufweisen, obwohl einige dies tun. Auch wenn Ihre Sprache es unterstützt, tun dies andere Sprachen, die möglicherweise auf Ihr Framework zugreifen, nicht. Alle APIs, die extern zugänglich sind, können sich daher nicht auf Groß-/Kleinschreibung alleine verlassen, um zwischen zwei Namen im selben Kontext zu differenzieren.

❌ Setzen Sie NICHT voraus, dass alle Programmiersprachen die Groß-/Kleinschreibung beachten. Das sind sie nicht. Namen dürfen sich nicht nur durch die Groß-/Kleinschreibung unterscheiden.

© Teile 2005, 2009 Microsoft Corporation. Alle Rechte vorbehalten.

Nachdruck mit freundlicher Genehmigung von Pearson Education, Inc., aus dem Buch Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition von Krzysztof Cwalina und Brad Abrams, veröffentlicht am 22. Oktober 2008 von Addison-Wesley Professional als Teil der Microsoft Windows Development Series.

Siehe auch