Freigeben über


Properties (MDX)

Aktualisiert: 12. Dezember 2006

Gibt eine Zeichenfolge oder einen stark typisierten Wert zurück, der den Wert einer Elementeigenschaft enthält.

Syntax

Member_Expression.Properties(Property_Name [, TYPED])

Argumente

  • Member_Expression
    Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der ein Element zurückgibt.
  • Property_Name
    Ein gültiger Zeichenfolgenausdruck, der den Namen einer Elementeigenschaft enthält.

Hinweise

Die Properties-Funktion gibt den Wert des angegebenen Elements für die angegebene Elementeigenschaft zurück. Die Elementeigenschaft kann entweder eine beliebige systeminterne Elementeigenschaft (beispielsweise NAME, ID, KEY, MEMBER_VALUE oder CAPTION) sein. Sie kann aber auch eine benutzerdefinierte Elementeigenschaft sein. Weitere Informationen finden Sie unter Integrierte Elementeigenschaften (MDX) und Benutzerdefinierte Elementeigenschaften (MDX).

Standardmäßig muss der Wert zwingend eine Zeichenfolge sein. Wenn TYPED angegeben wird, ist der Rückgabewert stark typisiert.

  • Bei einer systeminternen Eigenschaft gibt die Funktion den ursprünglichen Typ des Elements zurück.
  • Bei einem benutzerdefinierten Eigenschaftentyp entspricht der Typ des Rückgabewertes dem Typ des Rückgabewertes der MemberValue-Funktion.
ms144821.note(de-de,SQL.90).gifHinweis:
Properties ('Key') gibt dasselbe Ergebnis wie Key0 zurück, außer für zusammengesetzte Schlüssel. Properties ('Key') gibt für zusammengesetzte Schlüssel den Wert NULL zurück. Verwenden Sie die Keyx-Syntax für zusammengesetzte Schlüssel, wie im Beispiel veranschaulicht. Properties ('Key0'), Properties('Key1'), Properties('Key2') usw. bilden zusammen den zusammengesetzten Schlüssel.

Beispiele

Im folgenden Beispiel werden sowohl systemeigene als auch benutzerdefinierte Elementeigenschaften zurückgegeben. Dabei wird das TYPED-Argument verwendet, um den stark typisierten Wert für die Day Name-Elementeigenschaft zurückzugeben.

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]

Im folgenden Beispiel wird die Verwendung der KEYx-Eigenschaft veranschaulicht.

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]

Siehe auch

Verweis

MDX-Funktionsreferenz (MDX)

Konzepte

Verwenden von Elementeigenschaften (MDX)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

12. Dezember 2006

Geänderter Inhalt:
  • Der Inhalt in Bezug auf zusammengesetzte Schlüssel und die KEYx-Eigenschaft wurde aktualisiert.
  • Es wurde ein aktualisiertes Beispiel hinzugefügt.

17. Juli 2006

Geänderter Inhalt:
  • Syntax und Argumente wurden zur Verdeutlichung aktualisiert.
  • Aktualisierte Beispiele wurden hinzugefügt.