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.
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.