Komentarze (składnia MDX)

Komentarze to niewykonywane ciągi tekstowe w kodzie programu. (Komentarze są również znane jako uwagi). Możesz używać komentarzy do dokumentowania kodu lub tymczasowo wyłączyć części diagnostycznych instrukcji i skryptów Multidimensional Expressions (MDX). Używając komentarzy do dokumentowania kodu, możesz ułatwić przyszłe utrzymanie kodu programowego. Często używasz komentarzy do zapisywania nazwy programu, nazwiska autora oraz dat głównych zmian w kodzie. Możesz także używać komentarzy do opisu złożonych obliczeń lub wyjaśnienia metody programowania.

Komentarze na MDX spełniają następujące wytyczne:

  • W komentarzu można użyć wszystkich znaków alfanumerycznych lub symboli. Wszystkie postacie w komentarzu są ignorowane.

  • Nie ma maksymalnej długości komentarza w oświadczeniu lub scenariuszu. Komentarz może składać się z jednej lub kilku linijek.

MDX obsługuje trzy typy znaków komentujących:

(podwójne cięcia do przodu)
Te znaki komentarza mogą być używane na tej samej linii co kod do uruchomienia lub na osobnej linii. Wszystko, od podwójnych ukośników do przodu po koniec linii, jest częścią komentarza. W przypadku komentarza wielolinijowego podwójne ukośniki muszą pojawić się na początku każdej linii komentarza. Więcej informacji można znaleźć w (Komentarz) (MDX).

-- (podwójne myślniki)
Te znaki komentarza mogą być używane na tej samej linii co kod do uruchomienia lub na osobnej linii. Wszystko, od podwójnych łączników po koniec linijki, jest częścią komentarza. W przypadku komentarza wielolinijowego podwójne łączniki muszą pojawiać się na początku każdej linii komentarza. Więcej informacji można znaleźć pod adresem -- (Komentarz) (MDX).

/* ... */ (pary znaków z ukośnikiem w kształcie ukośnika)
Te znaki komentarza mogą być używane na tej samej linii co kod do uruchomienia, na wierszach samodzielnie, a nawet w kodzie wykonywalnym. Wszystko, od otwartej pary komentarzy (/*) po zamkniętą parę komentarzy (*/), jest uznawane za część komentarza. Dla komentarza wielolinijowego para znaków otwartego komentarza (/*) musi rozpocząć komentarz, a para znaków zamykającego komentarz (*/) musi zakończyć komentarz. Żadne inne postacie w komentarzu nie mogą pojawiać się w żadnej linijce komentarza. Więcej informacji można znaleźć w /*...*/ (Komentarz).

Example

Poniższe zapytanie pokazuje przykłady wszystkich trzech typów komentarzy:

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

Treści powiązane

  • Last updated on