Comentários (Sintaxe MDX)

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). Você pode usar comentários para documentar código ou desativar temporariamente partes de instruções e scripts de Expressões Multidimensionais (MDX) que estão sendo diagnosticados. Ao usar comentários para documentar o código, você pode facilitar a manutenção futura do código do programa. Você frequentemente usa comentários para registrar o nome do programa, o nome do autor e as datas das principais mudanças no código. Você também pode usar comentários para descrever cálculos complexos ou explicar um método de programação.

Os comentários no MDX seguem estas diretrizes:

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

  • Não há um comprimento máximo para um comentário dentro de uma declaração ou roteiro. 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 frente)
Esses caracteres de comentário podem ser usados na mesma linha que o código a ser executado ou em uma linha isoladamente. Tudo, desde os duplos cortes para frente até o fim da linha, faz parte do comentário. Para um comentário com múltiplas linhas, as barras duplas para frente devem aparecer no início de cada linha de comentário. Para mais informações, veja (Comentário) (MDX).

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

/* ... */ (par de caracteres com barra-asterisco para frente)
Esses caracteres de comentário podem ser usados na mesma linha que o código a ser executado, em linhas isoladas ou até mesmo dentro de código executável. Tudo, desde o par aberto de comentários (/*) até o par fechado de comentários (*/), é considerado parte do comentário. Para um comentário com múltiplas linhas, o par de caracteres de comentário aberto (/*) deve iniciar o comentário, e o par de caracteres de comentário fechado (*/) deve encerrar o comentário. Nenhum outro personagem de comentário pode aparecer em nenhuma linha do comentário. Para mais informações, veja /*...*/ (Comentário).

Exemplo

A consulta a seguir 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

  • Last updated on