Герберт Шилдт - C# 4.0 полное руководство - 2011

Если идентификаторное_выражение, следующее после директивы #if, истинно, то компилируется код (последовательность операторов), указываемый между ним и директивой #endif. В противном случае этот промежуточный код пропускается. Директива #endif обозначает конец блока директивы #if.

Идентификаторное выражение может быть простым, как наименование идентификатора. В то же время в нем разрешается применение следующих операторов: !, ==, ! =, & & и | |, а также круглых скобок.

Ниже приведен пример применения упомянутых выше директив.

// Продемонстрировать применение директив // #if, #endif и #define.

#define EXPERIMENTAL

using System;

class Test {

static void Main() {

#if EXPERIMENTAL

Console.WriteLine("Компилируется для экспериментальной версии."); #endif

Console.WriteLine("Присутствует во всех версиях.");

}

}

Этот код выдает следующий результат.

Компилируется для экспериментальной версии.

Присутствует во всех версиях.

В приведенном выше коде определяется идентификатор EXPERIMENTAL. Поэтому когда в этом коде встречается директива # i f , идентификаторное выражение вычисляется как истинное и затем компилируется первый оператор, содержащий вызов метода WriteLine () . Если же удалить определение идентификатора EXPERIMENTAL и перекомпилировать данный код, то первый оператор, содержащий вызов метода WriteLine () , не будет скомпилирован, поскольку идентификаторное выражение директивы # i f вычисляется как ложное. Но второй оператор, содержащий вызов метода WriteLine (), компилируется в любом случае, потому что он не входит в блок директивы #if.

Как пояснялось выше, в директиве # i f допускается указывать идентификаторное выражение. В качестве примера рассмотрим следующую программу.

// Использовать идентификаторное выражение.

#define EXPERIMENTAL #define TRIAL

class Test {

static void Main() {

#if EXPERIMENTAL

Console.WriteLine("Компилируется для экспериментальной версии."); #endif

#if EXPERIMENTAL && TRIAL

Console.Error.WriteLine("Проверка пробной экспериментальной версии. ") ;

#endif

Console.WriteLine("Присутствует во всех версиях.");

}

}

Эта программа дает следующий результат.

Компилируется для экспериментальной версии.

Проверка пробной экспериментальной версии.

Присутствует во всех версиях.

В данном примере определены два идентификатора: EXPERIMENTAL и TRIAL. Второй оператор, содержащий вызов метода WriteLine () , компилируется лишь в том случае, если определены оба идентификатора.

Для компилирования кода в том случае, если идентификатор не определен, можно воспользоваться оператором !, как в приведенном ниже примере.

#if !EXPERIMENTAL

Console.WriteLine("Этот код не экспериментальный!");

#endif

Вызов метода будет скомпилирован только в том случае, если идентификатор EXPERIMENTAL не определен.

Директивы #else и #elif

Директива #else действует аналогично условному оператору else языка С#, определяя альтернативный ход выполнения программы, если этого не может сделать директива #if . С учетом директивы #else предыдущий пример программы может быть расширен следующим образом.

// Продемонстрировать применение директивы #else.

#define EXPERIMENTAL

using System;

class Test {

static void Main() {

#if EXPERIMENTAL

Console.WriteLine("Компилируется для экспериментальной версии.");

#else

Console.WriteLine("Компилируется для окончательной версии.");

#endif

#if EXPERIMENTAL && TRIAL

Console.Error.WriteLine("Проверка пробной экспериментальной версии.");

#else

Console.Error.WriteLine("Это не пробная экспериментальная версия."); #endif