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

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

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

• В комментариях можно использовать все алфавитно-цифровые символы и знаки. Все символы в комментарии игнорируются.

• Длина комментария в инструкции или скрипте не ограничивается. Комментарии могут состоять из одной или нескольких строк.

В многомерных выражениях поддерживаются три типа символов комментария.

// (две косые черты)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, либо на отдельной строке. Комментарием является все, что находится после двух косых черт и до конца строки. Если комментарий занимает несколько строк, каждая строка комментария должна начинаться с двух косых черт. Дополнительные сведения см. в разделе (Комментарий) (многомерные выражения).

-- (двойной дефис)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, либо на отдельной строке. Комментарием является все, что находится после двойного дефиса и до конца строки. Если комментарий занимает несколько строк, каждая строка комментария должна начинаться с двойного дефиса. Дополнительные сведения см. в разделе -- (Примечание) (многомерные выражения).

/* ... */ (пары символов косой черты-звездочки)
Эти символы комментария могут вставляться на той же строке, что и исполняемый программный код, на отдельной строке, либо даже внутри исполняемого кода. Все, от открытой пары комментариев (/*) до пары близких комментариев (*/) считается частью комментария. Для комментария с несколькими строками пара символов открытого комментария (/*) должна запустить комментарий, а пара символов закрытия (*/) должна завершить комментарий. Строки комментария не должны содержать другие символы комментариев. Дополнительные сведения см. в разделе /*...*/ (Комментарий).

пример

Следующий запрос демонстрирует три типа комментариев:

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

См. также

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