Properties (многомерные выражения)

Статья
03/06/2015

Возвращает строку или строго типизированное значение, содержащее значение свойства элемента.

Синтаксис

Member_Expression.Properties(Property_Name [, TYPED])

Аргументы

Member_Expression
Допустимое многомерное выражение, возвращающее элемент.
Property_Name
Допустимое строковое выражение, обозначающее имя свойства элемента.

Замечания

Функция Properties возвращает значение заданного свойства указанного элемента. Функция поддерживает любые внутренние свойства элементов, например: NAME, ID, KEY или CAPTION, а также пользовательские свойства элементов. Дополнительные сведения см. в разделах Внутренние свойства элементов (многомерные выражения) и Пользовательские свойства элементов (многомерные выражения).

По умолчанию значение приводится к строке. Если указывается ключевое слово TYPED, возвращается строго типизированное значение.

Для свойства встроенного типа тип возвращаемого значения совпадает с типом свойства элемента.
Если тип свойства определен пользователем, тип возвращаемого значения совпадает с типом значения, возвращаемого функцией MemberValue.

Примечание
Функция Properties ('Key') возвращает тот же результат, что и Key0, за исключением составных ключей. Функция Properties ('Key') возвращает значение NULL для составных ключей. Для составных ключей используйте синтаксис Keyx, как это показано в данном примере. Функции Properties ('Key0'), Properties ('Key1'), Properties ('Key2') и т. д. совместно формируют составной ключ.

Функция Properties ('Key') возвращает тот же результат, что и Key0, за исключением составных ключей. Функция Properties ('Key') возвращает значение NULL для составных ключей. Для составных ключей используйте синтаксис Keyx, как это показано в данном примере. Функции Properties ('Key0'), Properties ('Key1'), Properties ('Key2') и т. д. совместно формируют составной ключ.

Пример

В следующем примере возвращаются и внутренние, и пользовательские свойства элемента, аргумент TYPED используется, чтобы вернуть строго типизированное значение свойства элемента Day Name.

WITH MEMBER Measures.MemberName AS 
   [Date].[Calendar].[July 1, 2003].Properties('Name')
MEMBER Measures.MemberVal AS 
   [Date].[Calendar].[July 1, 2003].Properties('Member_Value')
MEMBER Measures.MemberKey AS 
   [Date].[Calendar].[July 1, 2003].Properties('Key')
MEMBER Measures.MemberID AS 
   [Date].[Calendar].[July 1, 2003].Properties('ID')
MEMBER Measures.MemberCaption AS 
   [Date].[Calendar].[July 1, 2003].Properties('Caption')
MEMBER Measures.DayName AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day Name', TYPED)
MEMBER Measures.DayNameTyped AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day Name')
MEMBER Measures.DayofWeek AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Week')
MEMBER Measures.DayofMonth AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Month')
MEMBER Measures.DayofYear AS 
   [Date].[Calendar].[July 1, 2003].Properties('Day of Year')

SELECT {Measures.MemberName
   , Measures.MemberVal
   , Measures.MemberKey
   , Measures.MemberID
   , Measures.MemberCaption
   , Measures.DayName
   , Measures.DayNameTyped
   , Measures.DayofWeek
   , Measures.DayofMonth
   , Measures.DayofYear
   }  ON 0
FROM [Adventure Works]

В следующем примере показано использование свойства KEYx.

WITH 
MEMBER Measures.MemberKey AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key')
MEMBER Measures.MemberKey0 AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key0')
MEMBER Measures.MemberKey1 AS 
   [Customer].[Customer Geography].[State-Province].&[QLD]&[AU].Properties('Key1')
 
SELECT {Measures.MemberKey
   , Measures.MemberKey0
   , Measures.MemberKey1   
   }  ON 0
FROM [Adventure Works]

См. также

Справочник

Справочник по функциям многомерных выражений (многомерные выражения)

Основные понятия

Использование свойств элементов (многомерные выражения)

Поделиться через