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

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

  • Статья

Изменения: 12 декабря 2006 г.

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

Синтаксис

Member_Expression.Properties(Property_Name [, TYPED])

Аргументы

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

Замечания

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

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

  • Для свойства встроенного типа тип возвращаемого значения совпадает с типом свойства элемента.
  • Если тип свойства определен пользователем, тип возвращаемого значения совпадает с типом значения, возвращаемого функцией MemberValue.
ms144821.note(ru-ru,SQL.90).gifПримечание.
Функция 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]

См. также

Справочник

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

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

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

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия Журнал

12 декабря 2006 г.
Измененное содержимое
  • Обновлено содержимое, связанное с составными ключами и свойством KEYx.
  • Добавлен обновленный пример.

17 июля 2006 г.
Измененное содержимое
  • Обновлены синтаксис и аргументы для облегчения понимания.
  • Добавлены обновленные примеры.