Properties (MDX)
メンバ プロパティ値を含む文字列または厳密に型指定された値を返します。
構文
Member_Expression.Properties(Property_Name [, TYPED])
引数
Member_Expression
メンバを 1 つ返す有効な多次元式 (MDX) 式です。Property_Name
メンバ プロパティの名前を表す有効な文字列式です。
説明
Properties 関数は、指定されたメンバ プロパティに対応する指定されたメンバの値を返します。メンバ プロパティには、NAME、ID、KEY、CAPTION などの固有メンバ プロパティを任意に指定できます。また、ユーザー定義のメンバ プロパティを指定することもできます。詳細については、「固有メンバ プロパティ (MDX)」および「ユーザー定義メンバ プロパティ (MDX)」を参照してください。
既定では、強制的に文字列型の値が返されます。TYPED を指定すると、戻り値は厳密に型指定されます。
プロパティの型が組み込み型の場合、この関数はメンバの元の型を返します。
プロパティの型がユーザー定義型の場合、戻り値の型は、MemberValue 関数の戻り値の型と同じになります。
注意 |
---|
Key プロパティは、複合キーを除いて Key0 と同じ結果を返します。Key プロパティは、複合キーに関しては NULL を返します。例に示すように、複合キーには Keyx 構文を使用します。Key0 プロパティ、Key1 プロパティ、Key2 プロパティなどは、全体として複合キーを形成します。 |
例
次の例では、固有メンバ プロパティとユーザー定義メンバ プロパティを返しています。Day Name メンバ プロパティについては TYPED 引数を使用して、戻り値の型を厳密に指定しています。
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]