注释 (MDX 语法)

注释是程序代码中不可执行的文本字符串。 (评论也称为发言) 您可以使用注释来记录代码,或暂时禁用正在诊断的多维表达式(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]