.NET 预处理器指令
- C# 预处理器指令
虽然编译器没有单独的预处理器，但在处理该节中描述的指令时如同存在一个单独的预处理器；这些指令用于辅助条件编译。 与 C 和 C++ 指令不同，不能使用这些指令创建宏。预处理器指令必须是行上的唯一指令。
- #if
如果 C# 编译器遇到最后面跟有 #endif 指令的 #if 指令，则仅当指定的符号已定义时，它才会编译这两个指令之间的代码。 与 C 和 C++ 不同，您不能对符号赋予数值；C# 中的 #if 语句是 Boolean，仅测试符号是否已定义。
-
- 代码示例
#define DEBUG
#define MYTEST
using System;
public class MyClass
{
static void Main()
{
#if (DEBUG && !MYTEST)
Console.WriteLine("DEBUG is defined");
#elif (!DEBUG && MYTEST)
Console.WriteLine("MYTEST is defined");
#elif (DEBUG && MYTEST)
Console.WriteLine("DEBUG and MYTEST are defined");
#else
Console.WriteLine("DEBUG and MYTEST are not defined");
#endif
}
}
|
- #else
#else 允许您创建复合条件指令，因此，如果前面的 #if 或（可选）#elif 指令中的任何表达式都不为 true，则编译器将计算 #else 与后面的 #endif 之间的所有代码。
- #elif
#elif 使您得以创建复合条件指令。 如果前导 #if（C# 参考） 和任何可选前导 #elif 指令表达式的计算结果都不是 true，则将计算 #elif 表达式。 如果 #elif 表达式计算为 true，编译器将计算位于 #elif 和下一个条件指令之间的所有代码。
- #endif
#endif 指定以 #if 指令开头的条件指令的结尾。
- # define
#define 可让您定义符号。 当您将符号用作传递给 #if 指令的表达式时，此表达式的计算结果为 true。不能像在 C 和 C++ 中的通常做法一样，使用 #define 指令来声明常数值。最好是将 C# 中的常数定义为类或结构的静态成员。如果具有多个像这样的常数，可以考虑创建一个单独的“Constants”类来保存这些常数。
- #undef
#undef 使您可以取消符号的定义，以便通过将该符号用作 #if 指令中的表达式，使表达式的计算结果为 false。
可以使用 #define 指令或 /define 编译器选项定义符号。 在使用任何不是指令的语句之前，必须在文件中使用 #undef 指令。
-
- 代码示例
#undef DEBUG
using System;
class MyClass
{
static void Main()
{
#if DEBUG
Console.WriteLine("DEBUG is defined");
#else
Console.WriteLine("DEBUG is not defined");
#endif
}
}
|
- #warning
#warning 使您得以从代码的特定位置生成一级警告。#warning 通常用在条件指令中。也可以用 #error生成用户定义的错误。
-
- 代码示例
#define DEBUG
class MainClass
{
static void Main()
{
#if DEBUG
#warning DEBUG is defined
#endif
}
}
|
- #error
#error 使您可以从代码中的特定位置生成错误。#error 通常用在条件指令中。
-
- 代码示例
#define DEBUG
class MainClass
{
static void Main()
{
#if DEBUG
#error DEBUG is defined
#endif
}
}
|
- #line
#line 使您可以修改编译器的行号以及（可选）错误和警告的文件名输出。 下面的示例说明如何报告与行号关联的两个警告。 #line 200 指令将行号强制设置为 200（尽管默认行号为 #7），在执行下一条 #line 指令之前，文件名将报告为“Special”。 #line default 指令将行号恢复为默认行号，默认行号对前一条指令重新编号的行进行计数。
-
- 代码示例
class MainClass
{
static void Main()
{
#line 200 "Special"
int i; // CS0168 on line 200
int j; // CS0168 on line 201
#line default
char c; // CS0168 on line 9
float f; // CS0168 on line 10
#line hidden // numbering not affected
string s;
double d; // CS0168 on line 13
}
}
|
- #region
#region 使您可以在使用 Visual Studio 代码编辑器的大纲显示功能时指定可展开或折叠的代码块。 在较长的代码文件中，能够折叠或隐藏一个或多个区域会十分便利，这样，您可将精力集中于当前处理的文件部分。 #region 块必须以 #endregion 指令终止。#region 块不能与 #if 块重叠。但是，可以将 #region 块嵌套在 #if 块内，或将 #if 块嵌套在 #region 块内。
-
- 代码示例
#region MyClass definition
public class MyClass
{
static void Main()
{
}
}
#endregion
|
- #endregion
#endregion 标记 #region 块的结尾。
- #pragma
#pragma 为编译器提供特殊的指令，以说明如何编译包含杂注的文件。 这些指令必须是编译器支持的指令。 也就是说，不能使用 #pragma 创建自定义预处理指令。
-
- 代码示例
#pragma pragma-name pragma-arguments
|
- #pragma warning
#pragma warning 可启用或禁用某些警告。
-
- 代码示例
#pragma warning disable warning-list
#pragma warning restore warning-list
|
- #pragma checksum
生成源文件的校验和，以帮助调试 ASP.NET 页。
-
- 代码示例
#pragma checksum "filename" "{guid}" "checksum bytes"
|
