24.1 什么是预处理指令
C# 中没有实际的预处理程序,“预处理”指令由编译器处理,但这个术语被保留了下来。
24.2 基本规则
- 预处理指令必须和 C# 代码在不同的行。
- 预处理指令不需要以分号结尾。
- 包含预处理指令的每一行必须以“#”字符开始。
- “#”字符前可以有空格。
- 在“#”字符和指令之间可以有空格。
- 允许行尾注释。
- 预处理指令所在的行不允许有分隔符注释。
表 24.1 列出了预处理指令。
24.3 符号指令(#define、#undef )
编译符号是只有两种可能状态的标识符,要么被定义,要么未被定义。其具有如下特性:
- 可以是任何标识符(除 true 和 false 外),包括关键字,以及在 C# 代码中声明的标识符。
- 它没有值,不表示字符串。
- #define 声明一个编译符号。
- #undef 取消定义一个编译符号。
#define 和 #undef 只能用在源文件的第一行,即任何 C# 代码之前。
重复定义已存在的编译符号是被允许的。
定义一个标识符相当于将其值设置为 true,取消定义一个标识符相当于设置其值为 false。
24.4 条件编译(#if、#else、#elif、#endif)
条件编译允许根据某个编译符号是否被定义,来标注一段代码是否被编译或跳过。
- #if
- #else
- #elif
- #endif
24.5 条件编译结构
#if 和 #endif 需要配对使用,有 #if 指令,则必须有配对的 #endif 指令。
#if 和 #if … #else 结构
#if … #elif 和 #if … #elif … #else
24.6 诊断指令(#warning、#error)
诊断指令产生用户自定义的编译时警告及错误消息,其语法如下。需要注意,Message 是字符串,但不需要被引号包围。
当编译器遇到诊断指令时,会输出相关消息。诊断指令的消息会和编译器产生的警告和错误消息列在一起。
- #error 指令在 #if 结构中,只有满足 #if 条件时才会生成错误消息:“构建失败”。
- #warning 用于提醒程序会回头来清理一段代码。
24.7 行号指令(#line)
行号指令可以做如下事情:
- 改变编译器警告和错误消息报告的出现行数;
- 改变被编译源文件的文件名。
- 对交互式调试器隐藏一些行。
例如:
24.8 区域指令(#region、#endregion)
区域指令允许标注和有选择性地命名一段代码。区域由一个 #region 指令和其下方某处的一个 #endregion 指令构成。区域功能能够更轻松地浏览和组织代码。
例如,下面的代码定义了区域 Constructors,包含 2 个构造函数 MyClass。如果不想查看其中的代码,可以在 Rider 中将其折叠为一行。
24.9 警告开关指令(#pragma warning)
使用 #pragma warning 指令可以关闭或重新开启警告消息。
- disable:关闭警告消息。
- restore:开启警告消息。
关闭/开启特定警告消息
例如,下面的代码关闭 2 个警告消息 618 和 414,之后又开启了 618 警告消息。
关闭/开启所有警告消息文章来源:https://www.toymoban.com/news/detail-796110.html
若不带任何数字列表,则命令会应用于所有警告。文章来源地址https://www.toymoban.com/news/detail-796110.html
到了这里,关于C# 图解教程 第5版 —— 第24章 预处理指令的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!