Konventionen für die Groß-/KleinschreibungCapitalization Conventions

Die Richtlinien in diesem Kapitel stellen eine einfache Methode für den Fall dar, dass, wenn Sie konsistent angewendet wird, Bezeichner für Typen, Member und Parameter leicht lesbar werden.The guidelines in this chapter lay out a simple method for using case that, when applied consistently, make identifiers for types, members, and parameters easy to read.

Regeln für die Groß Schreibung für BezeichnerCapitalization Rules for Identifiers

Um Wörter in einem Bezeichner zu unterscheiden, sollten Sie den ersten Buchstaben jedes Worts im Bezeichner Großbuchstaben.To differentiate words in an identifier, capitalize the first letter of each word in the identifier. Verwenden Sie keine Unterstriche zur Unterscheidung von Wörtern oder an einer beliebigen Stelle in bezeichlern.Do not use underscores to differentiate words, or for that matter, anywhere in identifiers. Es gibt zwei geeignete Möglichkeiten, Bezeichner in Abhängigkeit von der Verwendung des Bezeichners zu nutzen:There are two appropriate ways to capitalize identifiers, depending on the use of the identifier:

  • PascalschreibweisePascalCasing

  • lowercamelcamelCasing

Die pascalidentifier-Konvention, die für alle Bezeichner mit Ausnahme von Parameternamen verwendet wird, erschließt das erste Zeichen jedes Worts (einschließlich der Akronyme über zwei Buchstaben), wie in den folgenden Beispielen gezeigt:The PascalCasing convention, used for all identifiers except parameter names, capitalizes the first character of each word (including acronyms over two letters in length), as shown in the following examples:

PropertyDescriptor
HtmlTag

Ein Sonderfall wird für aus zwei Buchstaben bestehende Akronyme gestellt, in denen beide Buchstaben groß geschrieben werden, wie im folgenden Bezeichner zu sehen:A special case is made for two-letter acronyms in which both letters are capitalized, as shown in the following identifier:

IOStream

Die für Parameternamen verwendete Konvention für die Groß-/Kleinschreibung nutzt das erste Zeichen jedes Worts außer dem ersten Wort, wie in den folgenden Beispielen gezeigt.The camelCasing convention, used only for parameter names, capitalizes the first character of each word except the first word, as shown in the following examples. Wie das Beispiel zeigt, sind zwei Buchstaben Akronyme, die mit einem Kamel Schreib Bezeichner beginnen, in Kleinbuchstaben.As the example also shows, two-letter acronyms that begin a camel-cased identifier are both lowercase.

propertyDescriptor
ioStream
htmlTag

✓ DO verwenden Sie PascalCasing für alle öffentlichen Member, Typnamen und Namespacenamen Namen aus mehreren Wörtern bestehen.✓ DO use PascalCasing for all public member, type, and namespace names consisting of multiple words.

✓ DO CamelCasing für Parameternamen verwenden.✓ DO use camelCasing for parameter names.

In der folgenden Tabelle werden die Regeln für die Groß-und Kleinschreibung für verschiedene Bezeichner Typen beschriebenThe following table describes the capitalization rules for different types of identifiers.

IDIdentifier SchreibweiseCasing BeispielExample
-NamespaceNamespace PasPascal namespace System.Security { ... }
TypType PasPascal public class StreamReader { ... }
BenutzeroberflächeInterface PasPascal public interface IEnumerable { ... }
-MethodeMethod PasPascal public class Object {
public virtual string ToString();
}
Die Eigenschaften-Property PasPascal public class String {
public int Length { get; }
}
EventEvent PasPascal public class Process {
public event EventHandler Exited;
}
FieldField PasPascal public class MessageQueue {
public static readonly TimeSpan
InfiniteTimeout;
}
public struct UInt32 {
public const Min = 0;
}
EnumerationswertEnum value PasPascal public enum FileMode {
Append,
...
}
ParameterParameter Groß-/Kleinschreibung gemischtCamel public class Convert {
public static int ToInt32(string value);
}

Groß Schreibung von zusammengesetzten Wörtern und allgemeinen BegriffenCapitalizing Compound Words and Common Terms

Die meisten zusammengesetzten Begriffe werden als einzelne Wörter für die Groß-/Kleinschreibung behandelt.Most compound terms are treated as single words for purposes of capitalization.

X DO NOT jedes Wort in so genannten geschlossener Form zusammengesetzte Wörter profitieren.X DO NOT capitalize each word in so-called closed-form compound words.

Dabei handelt es sich um zusammengesetzte Wörter, die als einzelnes Wort (z. b. Endpunkt)These are compound words written as a single word, such as endpoint. Um Richtlinien für die Groß-/Kleinschreibung zu beachten, behandeln Sie ein zusammengesetztes Wort als einzelnes Wort.For the purpose of casing guidelines, treat a closed-form compound word as a single word. Verwenden Sie ein Aktuelles Wörterbuch, um zu bestimmen, ob ein Verbund Wort in geschlossener Form geschrieben wurde.Use a current dictionary to determine if a compound word is written in closed form.

PasPascal Groß-/Kleinschreibung gemischtCamel notNot
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 KleinschreibungCase Sensitivity

Für Sprachen, die in der CLR ausgeführt werden können, ist es nicht erforderlich, die Groß-/Kleinschreibung zu unterstützen.Languages that can run on the CLR are not required to support case-sensitivity, although some do. Auch wenn Ihre Sprache Sie unterstützt, sind andere Sprachen, die möglicherweise auf Ihr Framework zugreifen, nicht.Even if your language supports it, other languages that might access your framework do not. Alle APIs, die extern zugänglich sind, können sich daher nicht allein auf die Groß-/Kleinschreibung verlassen, um zwischen zwei Namen im gleichen Kontext zu unterscheiden.Any APIs that are externally accessible, therefore, cannot rely on case alone to distinguish between two names in the same context.

X DO NOT wird davon ausgegangen, dass alle Programmiersprachen die Groß-/Kleinschreibung beachtet werden.X DO NOT assume that all programming languages are case sensitive. Das sind sie nicht.They are not. Namen dürfen nicht allein durch die Groß-/Kleinschreibung abweichenNames cannot differ by case alone.

Teile © 2005, 2009 Microsoft Corporation. Alle Rechte vorbehalten.Portions © 2005, 2009 Microsoft Corporation. All rights reserved.

Nachdruck mit Genehmigung von Pearson Education, Inc aus 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 durch Addison-Wesley Professional als Teil der Microsoft Windows Development Series.Reprinted by permission of Pearson Education, Inc. from Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition by Krzysztof Cwalina and Brad Abrams, published Oct 22, 2008 by Addison-Wesley Professional as part of the Microsoft Windows Development Series.

Siehe auchSee also