Kommentare (MDX-Syntax)

Kommentare sind nicht ausführende Textstrings im Programmcode. (Kommentare werden auch als Bemerkungen bezeichnet). Sie können Kommentare verwenden, um Code zu dokumentieren, oder Teile von Multidimensional Expressions (MDX)-Anweisungen und Skripten, die diagnostiziert werden, vorübergehend deaktivieren. Indem Sie Kommentare zur Dokumentation des Codes verwenden, können Sie die Wartung zukünftiger Programmcodes erleichtern. Sie verwenden häufig Kommentare, um den Programmnamen, den Autorennamen und die Daten größerer Codeänderungen festzuhalten. Du kannst auch Kommentare verwenden, um komplexe Berechnungen zu beschreiben oder eine Programmiermethode zu erklären.

Kommentare in MDX folgen diesen Richtlinien:

• Alle alphanumerischen Zeichen oder Symbole können im Kommentar verwendet werden. Alle Charaktere in einem Kommentar werden ignoriert.

• Es gibt keine maximale Länge für einen Kommentar innerhalb einer Aussage oder eines Skripts. Ein Kommentar kann aus einer oder mehreren Zeilen bestehen.

MDX unterstützt drei Arten von kommentierenden Zeichen:

(doppelte Schrägstriche)
Diese Kommentarzeichen können in derselben Zeile wie Code verwendet werden, der ausgeführt werden soll, oder auf einer Zeile einzeln. Alles, von den doppelten Vorwärtsschlägen bis zum Ende der Linie, gehört zum Kommentar. Für einen Kommentar mit mehreren Zeilen müssen die doppelten Vorwärtsstriche am Anfang jeder Kommentarzeile erscheinen. Weitere Informationen finden Sie unter (Kommentar) (MDX).

-- (doppelte Bindestriche)
Diese Kommentarzeichen können in derselben Zeile wie Code verwendet werden, der ausgeführt werden soll, oder auf einer Zeile einzeln. Alles von den doppelten Bindestrichen bis zum Ende der Zeile gehört zum Kommentar. Für einen Kommentar mit mehreren Zeilen müssen die doppelten Bindestriche am Anfang jeder Kommentarzeile erscheinen. Für weitere Informationen siehe -- (Kommentar) (MDX).

/* ... */ (vordere Schrägstrich-Sternchen-Zeichenpaare)
Diese Kommentarzeichen können in derselben Zeile wie Code verwendet werden, der ausgeführt werden soll, auf einzelnen Zeilen oder sogar innerhalb ausführbarer Codes. Alles vom offenen Kommentarpaar (/*) bis zum geschlossenen Kommentarpaar (*/) wird als Teil des Kommentars betrachtet. Für einen mehrzeiligen Kommentar muss das offene Kommentar-Zeichenpaar (/*) den Kommentar beginnen, und das Close-Comment-Zeichenpaar (*/) muss den Kommentar beenden. Keine anderen Kommentarcharaktere dürfen in irgendeiner Zeile des Kommentars erscheinen. Weitere Informationen finden Sie unter /*...*/ (Kommentar).

Example

Die folgende Abfrage zeigt Beispiele aller drei Kommentartypen:

//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]

Verwandte Inhalte

• MDX-Syntaxelemente (MDX)