Formateur C#

Formatez votre code C# selon les conventions Microsoft .NET.

C# Source

Formatage

Options

C# Formaté

Guide C#

Conventions de formatage C#

C# suit les conventions Microsoft .NET Framework Design Guidelines. La particularité de C# est l'utilisation du style Allman (accolades sur nouvelle ligne) contrairement à Java. Visual Studio et .NET CLI formatent automatiquement, mais cet outil est pratique pour du code partagé ou des snippets.

Conventions principales

Style Allman

L'accolade ouvrante va sur sa propre ligne, alignée avec l'instruction. Standard Microsoft.

4 espaces

Indentation standard. Visual Studio utilise 4 espaces par défaut.

PascalCase partout

Classes, méthodes, propriétés, namespaces. Seules les variables locales sont camelCase.

Préfixe _ privé

Convention moderne : _privateField pour les champs privés.

Bonnes pratiques

  • Nommage : PascalCase pour les membres publics, _camelCase avec underscore pour privés
  • Usings : Triez par System d'abord, puis les autres alphabétiquement
  • Propriétés auto : Préférez { get; set; } aux champs publics
  • Expression-bodied : Utilisez => pour les méthodes simples d'une ligne

Questions fréquentes

Allman vs K&R : quel style pour C# ?

Le style Allman (accolades sur nouvelle ligne) est le standard Microsoft pour C#. Le style K&R (accolades sur même ligne comme Java) est parfois utilisé mais moins courant. Visual Studio utilise Allman par défaut. Suivez la convention de votre équipe.

Dois-je préfixer les champs privés avec _ ?

La convention moderne et recommandée par Microsoft est _camelCase pour les champs privés. Cela distingue clairement les champs des paramètres et variables locales. L'ancienne convention avec this. est moins utilisée aujourd'hui.

Quand utiliser var vs type explicite ?

Utilisez var quand le type est évident : var user = new User(); var list = new List<string>();. Gardez le type explicite quand c'est ambigu : IEnumerable<User> users = GetUsers();. Le consensus moderne favorise var pour la lisibilité.

Comment organiser les membres d'une classe ?

Ordre suggéré : 1) Constantes et champs statiques, 2) Champs d'instance, 3) Constructeurs, 4) Propriétés, 5) Méthodes publiques, 6) Méthodes privées. Dans chaque groupe, publics d'abord puis privés. StyleCop peut automatiser cette vérification.