2.5.1 Symboles de compilation conditionnelle

La fonctionnalité de compilation conditionnelle offerte par les directives #if, #elif, #else et #endif est contrôlée par des expressions de prétraitement (Section 2.5.1) et des symboles de compilation conditionnelle.

conditional-symbol:

Tout identifier-or-keyword sauf true ou false

Un symbole de compilation conditionnelle peut prendre deux états : défini ou non défini. Au début du traitement lexical d'un fichier source, un symbole de compilation conditionnelle est non défini sauf s'il a été défini explicitement par un mécanisme externe (tel qu'une option du compilateur de ligne de commande). Lorsqu'une directive #define est traitée, le symbole de compilation conditionnelle nommé dans cette directive devient défini dans ce fichier source. Le symbole reste défini jusqu'au traitement d'une directive #undef pour ce même symbole ou jusqu'à ce que la fin du fichier source soit atteinte. L'une des conséquences de cela est que les directives #define et #undef dans un fichier source n'ont plus d'effet sur les autres fichiers sources dans le même programme.

Lorsqu'il est référencé dans une expression de prétraitement, un symbole de compilation conditionnelle défini possède la valeur Boolean true et un symbole de compilation conditionnelle non défini possède la valeur Boolean false. Il n'est pas nécessaire que des symboles de compilation conditionnelle soient explicitement déclarés avant d'être référencés dans les expressions de prétraitement. Les symboles non déclarés sont tout simplement non définis et prennent ainsi la valeur false.

L'espace de noms pour les symboles de compilation conditionnelle est distinct et séparé de toutes les autres entités nommées dans un programme C#. Les symboles de compilation conditionnelle peuvent uniquement être référencés dans les directives #define et #undef et dans des expressions de prétraitement.