分享方式:


批註 (MDX 語法)

批註是程式碼中未執行的文字字串。 (評論也稱為備註)。 您可以使用批註來記錄程式碼,或暫時停用要診斷的多維度運算式 (MDX) 語句和腳本部分。 藉由使用批註來記錄程式碼,您可以更輕鬆地進行未來的程式碼維護。 您經常使用批註來記錄程式名稱、作者名稱和主要程式碼變更的日期。 您也可以使用批註來描述複雜的計算,或說明程式設計方法。

MDX 中的批註遵循下列指導方針:

  • 所有英數位元或符號都可以在批註內使用。 批註中的所有字元都會被忽略。

  • 語句或腳本內的批註長度沒有上限。 批註可以由一或多行組成。

MDX 支援三種類型的批註字元:

(雙斜線)
這些批註字元可以用於與程式碼執行相同的行,或自行在行上使用。 從雙斜線到行尾的所有專案都是批註的一部分。 對於多行批註,雙斜線必須出現在每個批註行的開頭。 如需詳細資訊,請參閱 (批註)(MDX)。

-- (雙連字號)
這些批註字元可以用於與程式碼執行相同的行,或自行在行上使用。 從雙連字號到行尾的所有專案都是批註的一部分。 對於多行批註,雙連字號必須出現在每個批註行的開頭。 如需詳細資訊,請參閱 -- (批註) (MDX)

/* ... */ (正斜線星號字元組)
這些批註字元可以用於與程式碼執行相同的行、逐行執行,甚至是在可執行程式碼內使用。 從開放式批註組 (/*) 到關閉批註組 (*/) 的所有專案都會被視為批註的一部分。 對於多行批註,開啟批註字元組 (/*) 必須啟動批註,而關閉批註字元組 (*/) 必須結束批註。 沒有其他批註字元可以出現在批註的任何行上。 如需詳細資訊,請參閱 /*...*/ (批註)。

範例

下列查詢顯示這三種批註類型的範例:

//An example of a comment using the double-forward slash

--An example of a comment using the double-hypen  

/*An example of a  
multi-line  
comment*/  

SELECT  
  {[Measures].[Internet Sales Amount]} ON Columns,  
  [Date].[Calendar].MEMBERS ON Rows  
FROM [Adventure Works]

另請參閱

MDX 語法元素 (MDX)