注释是程序代码中不可执行的文本字符串。 (评论也称为发言) 您可以使用注释来记录代码,或暂时禁用正在诊断的多维表达式(MDX)语句和脚本中的部分内容。 通过使用注释来记录代码,你可以让未来的程序代码维护更简单。 你经常用注释记录程序名称、作者名和主要代码变更日期。 你也可以用注释来描述复杂的计算或解释编程方法。
MDX中的评论遵循以下指导原则:
评论中可以使用所有字母数字字符或符号。 评论中的所有字符都被忽略。
声明或脚本中评论没有最大长度限制。 一条评论可以由一行或多行组成。
MDX 支持三种类型的注释字符:
(双重前斩)
这些注释字符可以作为代码的同一行使用,也可以单独使用在一行代码中。 从双向前斜斩到句尾,评论里都有。 对于多行评论,双向斜杠必须出现在每条评论行的开头。 更多信息请参见(评论)(MDX)。
——(双连字符)
这些注释字符可以作为代码的同一行使用,也可以单独使用在一行代码中。 从双连字符到句尾,评论里的一切都是。 对于多行评论,双连字符必须出现在每条评论行的开头。 更多信息请参见——(评论)(MDX)。
/* ... */(斜线-星号字符对)
这些注释字符可以与要运行的代码在同一行使用,也可以单独使用,甚至在可执行代码中。 从开放评论对(/*)到关闭评论对(*/)都被视为评论的一部分。 对于多行评论,必须以开放评论字符对(/*)开始评论,关闭评论字符对(*/)必须结束评论。 评论的任何行中都不能出现其他评论字符。 更多信息请参见 /*...*/(评论)。
Example
以下查询展示了三种评论类型的示例:
//An example of a comment using the double-forward slash
--An example of a comment using the double-hyphen
/*An example of a
multi-line
comment*/
SELECT
{[Measures].[Internet Sales Amount]} ON Columns,
[Date].[Calendar].MEMBERS ON Rows
FROM [Adventure Works]