プロパティ (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')、Properties('Key1')、Properties('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]  
  

参照

メンバー プロパティの使用 (MDX)
MDX 関数リファレンス (MDX)