Namen von Typmembern
Aktualisiert: November 2007
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.
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
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.
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 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 im Buch "Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries" von Krzysztof Cwalina und Brad Abrams, veröffentlicht von Addison-Wesley, 2005.