Comentários (Sintaxe MDX)

Os comentários são cadeias de texto não executáveis no código do programa. (Comentários também são conhecidos como observações). Pode usar comentários para documentar código, ou desativar temporariamente partes de instruções e scripts de Expressões Multidimensionais (MDX) que estejam a ser diagnosticados. Ao usar comentários para documentar código, pode facilitar a manutenção futura do código do programa. Frequentemente usa comentários para registar o nome do programa, o nome do autor e as datas das principais alterações no código. Também pode usar comentários para descrever cálculos complexos ou explicar um método de programação.

Os comentários em MDX seguem estas diretrizes:

• Todos os caracteres ou símbolos alfanuméricos podem ser usados dentro do comentário. Todas as personagens dentro de um comentário são ignoradas.

• Não existe um comprimento máximo para um comentário dentro de uma declaração ou guião. Um comentário pode ser composto por uma ou mais linhas.

O MDX suporta três tipos de caracteres de comentário:

(duplo corte para a frente)
Estes caracteres de comentário podem ser usados na mesma linha do código a ser executado ou numa linha isoladamente. Tudo, desde os duplos cortes para a frente até ao fim da linha, faz parte do comentário. Para um comentário de várias linhas, as barras duplas para a frente devem aparecer no início de cada linha de comentário. Para mais informações, consulte (Comentário) (MDX).

-- (hífens duplos)
Estes caracteres de comentário podem ser usados na mesma linha do código a ser executado ou numa linha isoladamente. Tudo, desde os hífens duplos até ao fim da linha, faz parte do comentário. Para um comentário com várias linhas, os hífens duplos devem aparecer no início de cada linha de comentário. Para mais informações, veja -- (Comentário) (MDX).

/* ... */ (emparelhados de caracteres com barra-asterisco)
Estes caracteres de comentário podem ser usados na mesma linha que o código a ser executado, em linhas isoladas ou até dentro de código executável. Tudo, desde o par de comentários aberto (/*) até ao par de comentários fechado (*/), é considerado parte do comentário. Para um comentário de várias linhas, o par de caracteres de comentário aberto (/*) deve iniciar o comentário, e o par de caracteres de comentário fechado (*/) deve terminar o comentário. Nenhuma outra personagem de comentário pode aparecer em qualquer linha do comentário. Para mais informações, veja /*...*/ (Comentário).

Example

A consulta seguinte mostra exemplos dos três tipos de comentário:

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

Conteúdo relacionado

• Elementos de Sintaxe MDX (MDX)