Les Bases

1 - Anatomie d’un fichier source

Le code C# est écrit dans des fichiers source portant l’extension .cs. Dans le cas d’un programme web celle-ci sera .asp.

Il est fortement conseillé d’adopter le jeu de caractères ANSI non étendu (sans les caractères français). Tous les fichiers source doivent être encodés avec ce jeu de caractères, seules les parties de texte peuvent contenir des caractères français, voici un exemple ci-dessous.

using System;
    namespace demonstration
    {
        class HelloWorld {
             static void Main() {
                 Console.WriteLine ("Hello, World");
             }
    }

Voici les explications du code :
Using System;
Au début de chaque fichier de programme, il faut mettre la directive using pour spécifier au compilateur une liste de chemins de recherche implicites.

Par exemple, quand le compilateur rencontre la méthode “Console.WriteLine ("Hello, World");”, il s’aperçoit que son chemin n’est pas défini explicitement. Il balaie alors les espaces de noms spécifiés dans les using puis, une fois la méthode dénichée dans l’espace de nom System, il compile le code.

namespace demonstration
Cette ligne facultative définie un espace de nom qui va contenir les classes qui sont entre accolades dans notre exemple la classe bonjour. L’explication est la même dans le principe que celle donnée au-dessus, je vous laisse vous y reporter.

public class HelloWorld
Une application C# est une collection de classes, une classe étant un ensemble de données et de méthodes. Une méthode est un ensemble d’instructions appliquant un traitement aux données de la classe, retournant ou non un résultat logique ou typé (valeur numérique, chaîne de caractères, référence d’objet, etc.)

C’est le mot clé class qui introduit la déclaration de la classe, suivi du nom de la classe, d’une accolade ouvrante et d’une accolade fermante. Votre code sera placé entre les deux accolades.

static void Main()
Cette méthode est la méthode principale (main in english) de votre programme bonjour, c’est ici que vous placerez les actions à faire exécuter à C#.

Le mot-clef public signifie que la méthode est accessible au monde extérieur. Le mot clé static indique au compilateur que la méthode Main est globale et que, par conséquent, il est inutile d’instancier la classe pour pouvoir appeler la méthode. Comme elle est statique, le compilateur prend son adresse comme point d’entrée. De cette façon, l’environnement .NET sait par où commencer l’exécution de l’application.

Console.WriteLine("HelloWorld");
Pour l’instant, intéressons-nous à WriteLine( ), qui veut dire “écris ce que je te donne sur une ligne de la console”. C’est magnifique, vous savez faire écrire une phrase ! Ne vous inquiétez pas après l’écriture viendront les calculs !

2 - Le bloc de code

{
    // Faire une tabulation
    // Tout le code est frappé à cette hauteur
}
// Retrait de la tabulation
// Tout le code est frappé à cette hauteur

Cette méthode permet de contrôler la fermeture des accolades et de leurs correspondances.

3 - Affichage de texte

L’affichage de texte s’effectue grâce à la commande Console.Write().

Console.WriteLine ("Hello, World");

Il existe en fait 2 méthodes d’affichage :

• Console.Write() : affiche du texte et reste sur la même ligne,
• Console.WriteLine() : affiche du texte et fait un saut de ligne

4 - Commentaires

Les commentaires doivent permettre à quelqu’un, de pouvoir lire et comprendre ce qui se passe. Les commentaires sont indispensables à tout bon programme.

Il y a deux façons de placer des commentaires :

• soit en utilisant /*Commentaire*/, qui permet aussi un commentaire sur plusieurs lignes,
• soit en utilisant //. Le reste de la ligne est un commentaire où le commentaire se termine à la fin de la ligne.

Microsoft a introduit la génération automatique de documentation basée sur le XML. Pour l’obtenir, il suffit de saisir /// devant chaque déclaration de méthode

On obtient le code suivant :

/// <summary>
/// Commentaire ...
/// <summary>

5 - l’indentation

Revenons à notre exemple. Le code n’est pas, en totalité, positionné à droite. À chaque nouveau bloc le code est décalé vers la droite. C’est ce qu’on appelle l’indentation. Elle existe dans tous les langages, c’est une bonne pratique qui rend le code plus lisible.

using System;
    namespace demonstration
    {
        class HelloWorld {
             static void Main() {
                 Console.WriteLine ("Hello, World");
             }
    }

• faire un saut après une virgule,
• faire un saut après un opérateur (un + par exemple)
• aligner le début de la nouvelle ligne au même niveau que la précédente.

longMethodCall(expr1, expr2,
                   expr3, expr4, expr5);

Mauvais saut

var = a * b / (c - g +
                   f) + 4 * z;

Meilleure méthode

var = a * b / (c - g +f) +
                    4 * z;

6 - Conventions de nommage

La notation hongroise

• On ajoute un préfixe à chaque variable pour indiquer son type.
• Exemple : btnRetour pour bouton Retour
• Toutefois, les préfixes ne sont pas standardisés et on doit en inventer pour les nouveaux types.
• Puisque C# est un langage fortement typé et que la hiérarchie de classes est très stricte, on ne suggère pas d’utiliser cette notation.

La casse Pascal

• La première lettre est en majuscule.
• On sépare les mots en mettant leur première lettre en majuscule.
• Exemple : AfficherCustomer
• Vous remarquerez que les espaces de noms et les classes de bases du Framework respectent cette casse.

La casse Camel

• La première lettre est en minuscule.
• On sépare les mots en mettant leur première lettre en majuscule.
• Exemple : testCompteur

La casse Majuscule

• Toutes les lettres sont en majuscule pour les constantes d’une ou deux lettres
• Exemple : PI
• Si le nom est trop long, utilisez la casse Pascal

La casse Snake

• Toutes les lettres sont en minuscule
• On sépare les mots avec un underscore (_)
• Exemple : afficher_customer
  Note Il est fortement déconseillé de séparer les mots par des traits de soulignement (underscore) : Afficher_Customer est donc déconseillé.

Nommage des noms