Комментарии (синтаксис многомерных выражений)
Комментарии — это невыполняемые строки кода программы (их также называют пометками). Комментарии используются для документирования кода или временного отключения фрагментов инструкций и сценариев многомерных выражений для отладки. Документирование кода при помощи комментариев упрощает его дальнейшее обслуживание. Комментарии часто используют, чтобы записать имя программы, имя автора и даты основных изменений кода. Кроме того, комментарии можно использовать для пояснения сложных вычислений и описания метода программирования.
При использовании комментариев в многомерных выражениях необходимо помнить следующее.
В комментариях можно использовать все алфавитно-цифровые символы и знаки. Служба MicrosoftSQL ServerAnalysis Services не обрабатывает символы в комментариях.
Длина комментария в инструкции или сценарии не ограничивается. Комментарии могут состоять из одной или нескольких строк.
В многомерных выражениях поддерживаются три типа символов комментария.
// (две косые черты)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, либо на отдельной строке. Комментарием является все, что находится после двух косых черт и до конца строки. Если комментарий занимает несколько строк, каждая строка комментария должна начинаться с двух косых черт. Дополнительные сведения см. в разделе // (комментарий) (многомерные выражения).-- (двойной дефис)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, либо на отдельной строке. Комментарием является все, что находится после двойного дефиса и до конца строки. Если комментарий занимает несколько строк, каждая строка комментария должна начинаться с двойного дефиса. Дополнительные сведения см. в разделе -- (комментарий) (многомерные выражения)./* ... */ (пара символов «косая черта + звездочка»)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, на отдельной строке, либо даже внутри исполняемого кода. Комментарием является все, что находится между открывающей (/*) и закрывающей (*/) парой символов. Между открывающим (/*) и закрывающим (*/) символами комментария может находиться несколько строк. Строки комментария не должны содержать другие символы комментариев. Дополнительные сведения см. в разделе /*...*/ (комментарий).
Примеры
Следующий запрос демонстрирует три типа комментариев.
//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]