Noms de membres de type
Les types contiennent les catégories de membres suivantes :
Méthodes
Propriétés
Champs
Événements
Les règles de cette section aident les concepteurs de bibliothèques de classes à sélectionner des noms de membres cohérents avec le .NET Framework.
Noms des méthodes
Attribuez aux méthodes des noms représentant des verbes ou des syntagmes verbaux.
Puisqu'en général les méthodes agissent sur les données, l'utilisation d'un verbe décrivant l'action de la méthode permet aux développeurs de comprendre plus facilement le rôle de la méthode. Lorsque vous définissez l'action exécutée par la méthode, veillez à sélectionner un nom clair et sans ambiguïté du point de vue du développeur. Ne sélectionnez pas un verbe expliquant comment la méthode effectue l'action requise ; en d'autres termes, n'utilisez pas de détails d'implémentation dans votre nom de méthode.
Noms des propriétés
Nommez des propriétés à l'aide d'un nom, d'un syntagme nominal ou d'un adjectif.
Les syntagmes nominaux ou les adjectifs conviennent dans le cas des propriétés car celles-ci contiennent des données.
N'utilisez pas de propriétés qui correspondent aux noms des méthodes Get.
Par exemple, n'attribuez pas le nom EmployeeRecord à une propriété et le nom GetEmployeeRecord à une méthode. Les développeurs ne sauront pas quel membre utiliser pour accomplir leur tâche de programmation.
Attribuez aux propriétés de type Boolean une expression affirmative (CanSeek au lieu de CantSeek). Éventuellement, vous pouvez également ajouter aux propriétés Boolean le préfixe Is, Can ou Has, mais uniquement dans le cas où il ajoute de la valeur.
Envisagez d'attribuer à une propriété le même nom que son type.
Dans le cas d'une propriété fortement typée en énumération, le nom de la propriété peut être identique à celui de l'énumération. Si, par exemple, vous avez une énumération nommée CacheLevel, une propriété qui retourne l'une de ses valeurs peut être également nommée CacheLevel.
Noms des événements
Attribuez aux événements un nom représentant un verbe ou un syntagme verbal.
Précisez la notion de temps (avant ou après) dans les noms d'événements en utilisant le présent et le passé. Par exemple, un événement de fermeture déclenché avant la fermeture d'une fenêtre peut être appelé Closing et celui déclenché après la fermeture peut être appelé Closed.
N'utilisez pas de préfixes ou de suffixes tels que Before ou After pour indiquer l'antériorité ou la postériorité des événements.
Faites suivre les noms des gestionnaires d'événements (des délégués utilisés comme types d'événements) du suffixe EventHandler.
Utilisez deux paramètres nommés sender et e dans les signatures de gestionnaire d'événements.
Le paramètre sender doit être de type Object, et le paramètre e doit être une instance de EventArgs ou hériter de celui-ci.
Ajoutez le suffixe EventArgs aux classes d'argument d'événement.
Noms des champs
Les règles concernant les noms de champs s'appliquent aux champs protégés et publics statiques. Vous ne devez pas définir de champs d'instance publics ou protégés. Pour plus d'informations, consultez Conception de champs.
Utilisez la casse Pascal dans les noms des champs.
Utilisez des noms ou de syntagmes nominaux comme noms de champs.
N'utilisez pas de préfixe dans les noms de champs. Par exemple, n'utilisez pas g_ ou s_ pour distinguer des champs statiques et non statiques.
Portions Copyright 2005 Microsoft Corporation. Tous droits réservés.
Portions Copyright Addison-Wesley Corporation. Tous droits réservés.
Pour plus d'informations sur les règles de conception, consultez « règles de conception d'infrastructure : Conventions idiomes et modèles carnet de bibliothèques réutilisables framework » Krzysztof Cwalina et Brad Abrams, publiés par Addison-Wesley, 2005.
Voir aussi
Autres ressources
Instructions de conception pour le développement de bibliothèques de classes