Attribution d'un nom à des paramètres
Remarque
Ce contenu est réimprimé avec l’autorisation de Pearson Education, Inc. à partir des Instructions de conception d’une infrastructure : conventions, idiomes et modèles des bibliothèques réutilisables .NET, 2ème édition. Cette édition a été publiée en 2008, et le livre a été entièrement révisé dans la troisième édition. Certaines informations de cette page peuvent être obsolètes.
Au-delà de la question évidente de la lisibilité, il est important de suivre les instructions relatives aux noms de paramètres, car les paramètres sont affichés dans la documentation et dans le concepteur lorsque les outils de conception visuelle fournissent des fonctionnalités Intellisense et de navigation de classe.
✔️ UTILISEZ la casseMixte dans les noms de paramètres.
✔️ UTILISEZ des noms de paramètres descriptifs.
✔️ ENVISAGEZ d’utiliser des noms basés sur la signification d’un paramètre plutôt que sur le type du paramètre.
Nommage des paramètres de surcharge d’opérateur
✔️ UTILISEZ left et right pour les noms de paramètres de surcharge d’opérateur binaire si les paramètres n’ont aucune signification.
✔️ UTILISEZ value pour les noms de paramètres de surcharge d’opérateur unaire si les paramètres n’ont aucune signification.
✔️ ENVISAGEZ des noms significatifs pour les paramètres de surcharge de l’opérateur si cela ajoute une valeur significative.
❌ N’utilisez PAS d’abréviations ou d’index numériques pour les noms de paramètres de surcharge d’opérateur.
Portions © 2005, 2009 Microsoft Corporation. Tous droits réservés.
Réimprimé avec l’autorisation de Pearson Education, Inc. et extrait de Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition par Krzysztof Cwalina et Brad Abrams, publié le 22 octobre 2008 par Addison-Wesley Professional dans le cadre de la série sur le développement Microsoft Windows.