Aération
Retour de ligne
Il est généralement préférable de mettre quelques lignes vide dans le code source pour qu'il ne soit pas trop collé, ce qui est généralement plus difficile à lire. Vous devez obligatoirement mettre des lignes vide dans le code pour l'aérer. Pour savoir où mettre ces lignes vides, utilisez le guide suivant:
- Ajoutez une ligne vide après une fermeture de bloc { ... }. Dans l'exemple ci-dessous, notez la ligne vide ajouté après la fermeture du bloc if. Ces lignes vides doivent aussi être ajouté après les blocs des boucles, des classes, switch/case ou tout autre élément du langage de programmation utilisant des blocs de code.Il y a toutefois une exception à cette règle. Vous ne devez pas mettre de ligne vide entre deux fermetures de bloc qui sont l'une après l'autre. Dans l'exemple ci-dessous, notez qu'il n'y a pas de ligne vide entre la fermeture du if et de la boucle for.C#C#
- Ajoutez une ligne vide après toute série d'instructions qui se distingue des lignes suivantes. Ces lignes vide sont un peu subjective d'un programmeur à l'autre, mais sont essentielle à la compréhension du code pour bien regrouper les lignes ayant un sens similaire. Dans l'exemple ci-dessous, notez bien la ligne vide entre les lignes permettant de calculer la somme et les lignes utilisant la somme.C#
- Ajoutez une ligne vide avant chaque commentaire de ligne à moins que celui-ci se retrouve en début de bloc. Dans l'exemple ci-dessous, notez la ligne vide juste avant le commentaire au milieu du bloc et l'absence de ligne vide avant le commentaire en début de bloc.C#
À éviter
Bien que l'aération du code soit bien pour la lisibilité du code, il est facile de s'emporter et d'en ajouter trop. Évitez d'ajouter des lignes vides autre que pour les situations mentionnées ci-dessus. De plus, évitez de mettre plusieurs lignes vide de suite comme l'exemple ci-dessous. C'est une mauvaise pratique. Une seule ligne vide à la fois est nécessaire.
C#