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.
Typen umfassen die folgenden Arten von Membern:
Methoden
Eigenschaften
Felder
Ereignisse
Anhand der Richtlinien in diesem Abschnitt können Entwickler von Klassenbibliotheken Namen für Member festlegen, die mit .NET Framework konsistent sind.
Namen von Methoden
Legen Sie für Methoden Namen fest, die Verben oder verbale Ausdrücke sind.
Methoden behandeln i. d. R. Daten. Daher erleichtert die Verwendung eines Verbs zum Beschreiben der Aktion der Methode Entwicklern das Verständnis der Funktion der Methode. Wenn Sie die von der Methode ausgeführte Aktion definieren, wählen Sie einen für den Entwickler deutlichen Namen aus. Wählen Sie kein Verb aus, das beschreibt, wie die Methode ihre Aktion ausführt, verwenden Sie also keine Implementierungsdetails als Methodenname.
Namen von Eigenschaften
Benennen Sie Eigenschaften mit einem Substantiv, einem substantivischen Ausdruck oder einem Adjektiv.
Substantivische Ausdrücke oder Adjektive sind für Eigenschaften geeignet, da Eigenschaften Daten enthalten.
Verwenden Sie keine Eigenschaftennamen, die mit den Namen von Get-Methoden übereinstimmen.
Nennen Sie z. B. eine Eigenschaft nicht EmployeeRecord und gleichzeitig eine Methode GetEmployeeRecord. Die Entwickler wissen dann nicht, welchen Member sie für ihre Programmieraufgabe verwenden sollen.
Benennen Sie boolesche Eigenschaften mit einem positiven Begriff (CanSeek statt CantSeek). Sie können booleschen Eigenschaften auch das Präfix Is, Can oder Has voranstellen, doch nur, sofern dies sinnvoll ist.
Möglicherweise empfiehlt es sich, für eine Eigenschaft den gleichen Namen wie für ihren Typ festzulegen.
Wenn eine Eigenschaft eine starke Typisierung als Enumeration aufweist, kann der Name der Eigenschaft mit dem Namen der Enumeration übereinstimmen. Wenn beispielsweise der Name einer Enumeration CacheLevel lautet, kann eine Eigenschaft, die einen der Enumerationswerte zurückgibt, ebenfalls CacheLevel lauten.
Namen von Ereignissen
Benennen Sie Ereignisse mit einem Verb oder einem verbalen Ausdruck.
Verwenden Sie für Ereignisnamen ein Konzept von vorher und nachher, indem Sie die Gegenwarts- und Vergangenheitsform verwenden. Beispielsweise wird ein Schließereignis, das vor dem Schließen eines Fensters ausgelöst wird, mit Closing benannt, und der Name eines nach dem Schließen des Fensters ausgelösten Ereignisses lautet Closed.
Verwenden Sie nicht die Präfixe oder Suffixe Before und After, um vorherige und spätere Ereignisse anzugeben.
Benennen Sie Ereignishandler (als Typen von Ereignissen verwendete Delegaten) mit dem Suffix EventHandler.
Verwenden Sie in Ereignishandlersignaturen zwei Parameter mit den Namen sender bzw. e.
Der sender-Parameter muss vom Typ Object sein, und der e-Parameter muss eine Instanz von EventArgs sein oder von dieser Klasse erben.
Benennen Sie Ereignisargumentklassen mit dem Suffix EventArgs.
Namen von Feldern
Die Benennungsrichtlinien für Felder gelten für statische öffentliche und geschützte Felder. Definieren Sie keine öffentlichen oder geschützten Instanzfelder. Weitere Informationen finden Sie unter Feldentwurf.
Verwenden Sie für Feldnamen die Pascal-Schreibweise.
Benennen Sie Felder mit Substantiven oder substantivischen Ausdrücken.
Verwenden Sie für Feldnamen kein Präfix. Verwenden Sie z. b. nicht g_ oder s_, um statische Felder von nicht statischen Feldern zu unterscheiden.
Copyright für einzelne Teile 2005 Microsoft Corporation. Alle Rechte vorbehalten.
Copyright für einzelne Teile Addison-Wesley Corporation. Alle Rechte vorbehalten.
Weitere Informationen zu Entwurfsrichtlinien finden Sie unter „Framework-Entwurfs-Richtlinien: Idiome, Konventionen und Muster für wiederverwendbare .NET-Bibliotheken von Krzysztof Cwalina“ book und Brad Abrams, veröffentlicht von Addison-Wesley, 2005.