Commenti (sintassi MDX)

I commenti sono stringhe di testo contenute nel codice di un programma ma che non vengono eseguite . È possibile utilizzare i commenti per documentare il codice o disabilitare temporaneamente parti di un'istruzione MDX (Multidimensional Expressions) o di uno script durante la diagnostica del codice. Se si utilizzano i commenti per documentare il codice, la successiva manutenzione del codice risulterà più semplice. I commenti vengono in genere utilizzati per registrare dettagli quali il nome del programma, il nome dell'autore e le date delle principali modifiche apportate al codice. È inoltre possibile utilizzare i commenti per descrivere calcoli complessi o illustrare un metodo di programmazione.

Di seguito sono riportate le linee guida per l'utilizzo dei commenti in MDX:

  • In un commento è possibile utilizzare qualsiasi carattere alfanumerico o simbolo. Tutti i caratteri all'interno di un commento vengono ignorati.

  • Per i commenti di uno script o istruzione non è prevista una lunghezza massima. Un commento può essere formato da una o più righe.

MDX supporta gli indicatori di commento seguenti:

// (barra doppia)
Questo indicatore di commento può essere utilizzato sulla stessa riga del codice da eseguire o su una riga a parte. Tutti i caratteri situati tra la barra doppia e la fine della riga vengono trattati come commento. Per commenti su più righe, specificare la barra doppia all'inizio di ogni riga di commento. Per altre informazioni, vedere (Commento) (MDX).

-- (trattino doppio)
Questo indicatore di commento può essere utilizzato sulla stessa riga del codice da eseguire o su una riga a parte. Tutti i caratteri situati tra il trattino doppio e la fine della riga vengono trattati come commento. Per commenti su più righe, specificare il trattino doppio all'inizio di ogni riga di commento. Per altre informazioni, vedere -- (Commento) (MDX).

/* ... */ (coppie di caratteri barra asterisco)
Questo indicatore di commento può essere utilizzato sulla stessa riga del codice da eseguire, su una riga a parte o all'interno del codice eseguibile. Tutti gli elementi della coppia di commenti aperta (/*) alla coppia di commenti di chiusura (*/) sono considerati parte del commento. Per un commento a più righe, la coppia di caratteri apri commento (/*) deve avviare il commento e la coppia di caratteri di commento di chiusura (*/) deve terminare il commento. Nelle righe del commento non deve essere inserito nessun altro simbolo di commento. Per altre informazioni, vedere /*...*/ (Commento).

Esempio

Nella query seguente vengono illustrati esempi dei tre tipi di commento:

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

Vedi anche

Elementi della sintassi MDX (MDX)