Commentaires (syntaxe MDX)
Les commentaires sont des chaînes de texte non exécutables figurant dans un code de programmation (les commentaires sont également appelés remarques). Vous pouvez utiliser des commentaires pour documenter du code ou désactiver temporairement des parties d'instructions et de scripts MDX (Multidimensional Expressions) en cours d'analyse. En utilisant des commentaires pour documenter le code, vous pouvez faciliter la maintenance future du code de programme. Les commentaires servent souvent à enregistrer le nom du programme, le nom de l'auteur et les dates des principales mises à jour. Vous pouvez également utiliser des commentaires pour décrire des calculs compliqués ou expliquer une méthode de programmation.
Les commentaires de la syntaxe MDX respectent les principes suivants :
Tous les caractères alphanumériques ou les symboles peuvent être utilisés dans un commentaire. Tous les caractères d’un commentaire sont ignorés.
La longueur d'un commentaire dans une instruction ou un script n'est pas limitée. Un commentaire peut être composé d’une ou plusieurs lignes.
La syntaxe MDX prend en charge trois types de caractères de commentaire :
// (doubles barres obliques)
Ces caractères de commentaire peuvent être utilisés directement dans une ligne de code ou en début de ligne. Tout ce qui se trouve entre les doubles barres obliques et la fin de ligne fait partie du commentaire. Pour un commentaire de plusieurs lignes, les doubles barres obliques doivent apparaître au début de chaque ligne. Pour plus d’informations, consultez (Commentaire) (MDX).
-- (doubles tirets)
Ces caractères de commentaire peuvent être utilisés directement dans une ligne de code ou en début de ligne. Tout ce qui se trouve entre les doubles tirets et la fin de ligne fait partie du commentaire. Pour un commentaire de plusieurs lignes, les doubles tirets doivent apparaître au début de chaque ligne. Pour plus d’informations, consultez -- (Commentaire) (MDX).
/* ... */ (paires de caractères barre oblique-astérisque)
Ces caractères de commentaire peuvent être utilisés directement dans une ligne de code devant être exécuté, en début de ligne ou même dans du code exécutable. Tout ce qui se trouve entre le commentaire ouvrant (/*) et le commentaire fermant (*/) fait partie du commentaire. Dans le cas d'un commentaire de plusieurs lignes, les deux caractères du commentaire ouvrant (/*) doivent débuter le commentaire, et ceux du commentaire fermant (*/) le terminer. Aucun autre caractère de commentaire ne peut apparaître dans les lignes de commentaire. Pour plus d’informations, consultez /*...*/ (Commentaire).
Exemple
La requête suivante offre des exemples des trois types de commentaire :
//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]