Preprocessor Directives
Preprocessor directives supply the compiler with additional information about regions of code. The most common preprocessor directives are the conditional directives, which provide a way to include or exclude regions of code from compilation. For example:
#define DEBUG
class MyClass { int x; void Foo() {# if DEBUG
Console.WriteLine ("Testing: x = {0}", x);# endif
}
... }
In this class, the statement in Foo
is compiled as conditionally dependent upon
the presence of the DEBUG
symbol. If we
remove the DEBUG
symbol, the statement is not compiled.
Preprocessor symbols can be defined within a source file (as we have
done), and they can be passed to the compiler with the /define:
symbol command-line
option.
With the #if
and #elif
directives, you can use the ||
, &&
, and !
operators to perform or,
and, and not operations on
multiple symbols. The following directive instructs the compiler to
include the code that follows if the TESTMODE
symbol is defined and the DEBUG
symbol is not defined:
#if TESTMODE && !DEBUG ...
Bear in mind, however, that you’re not building an ordinary C# expression, and the symbols upon which you operate have absolutely no connection to variables—static or otherwise.
The #error
and #warning
symbols prevent accidental misuse of
conditional directives by making the compiler generate a warning or error
given an undesirable set of compilation symbols.
Here is a complete list of preprocessor directives:
Preprocessor directive | Action |
---|---|
| Defines ... |
Get C# 5.0 Pocket Reference now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.