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

Статья
05/23/2023

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

Синтаксис

  
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') и т. д. совместно формируют составной ключ.

пример

В следующем примере возвращаются и внутренние, и пользовательские свойства элемента, аргумент 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]

См. также

Использование свойств элементов (многомерные выражения)
Справочник по функции многомерных выражений (многомерные выражения)