註解是程式程式碼中非執行的文字字串。 (評論也稱為發言) 你可以使用註解來記錄程式碼,或暫時停用正在診斷的多維表達式(MDX)語句和腳本中的部分內容。 透過註解來記錄程式碼,你可以讓未來的程式程式碼維護變得更容易。 你經常用註解來記錄程式名稱、作者名稱以及主要程式碼變更的日期。 你也可以用註解來描述複雜的計算或解釋程式設計方法。
MDX 的留言遵循以下指引:
所有字母數字或符號都可以在註解中使用。 留言中的所有角色都會被忽略。
陳述或腳本中評論沒有最大長度限制。 一則評論可以由一行或多行組成。
MDX 支援三種類型的註解字元:
(雙重前斬)
這些註解字元可以與待執行的程式碼同一行使用,或單獨使用在同一行。 從雙重前斜擊到台詞末端,都是留言的一部分。 對於多行評論,雙向斜線必須出現在每行評論行的開頭。 欲了解更多資訊,請參閱(評論)(MDX)。
-- (雙連字號)
這些註解字元可以與待執行的程式碼同一行使用,或單獨使用在同一行。 從雙連字號到句尾,所有細節都包含在留言中。 對於多行評論,雙連字號必須出現在每行評論行的開頭。 欲了解更多資訊,請參見 -- (評論)(MDX)。
/* ... */(斜線星號字元對)
這些註解字元可以與執行的程式碼同一行使用,也可以單獨使用,甚至在可執行程式碼中使用。 從開放留言對(/*)到封閉留言對(*/)都被視為留言的一部分。 對於多行評論,開留言的字元對(/*)必須開始該註解,閉合評論的字元對(*/)必須結束該註解。 評論的任何行中都不得出現其他留言角色。 欲了解更多資訊,請參閱 /*...*/(留言)。
範例
以下查詢展示了三種評論類型的範例:
//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]