Поделиться через


Комментарии (синтаксис многомерных выражений)

Комментарии — это невыполняемые строки кода программы (их также называют пометками). Комментарии используются для документирования кода или временного отключения фрагментов инструкций и скриптов многомерных выражений для отладки. Документирование кода при помощи комментариев упрощает его дальнейшее обслуживание. Комментарии часто используют, чтобы записать имя программы, имя автора и даты основных изменений кода. Кроме того, комментарии можно использовать для пояснения сложных вычислений и описания метода программирования.

При использовании комментариев в многомерных выражениях необходимо помнить следующее.

  • В комментариях можно использовать все алфавитно-цифровые символы и знаки. Служба Microsoft SQL Server Analysis 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]

См. также

Основные понятия

Синтаксические элементы в многомерных выражениях (многомерные выражения)