StrToMember (MDX)
Gibt das durch eine Zeichenfolge im MDX-Format (Multidimensional Expressions) angegebene Element zurück.
Syntax
StrToMember(Member_Name [,CONSTRAINED] )
Argumente
- Member_Name
Ein gültiger Zeichenfolgenausdruck, der direkt oder indirekt ein Element angibt.
Hinweise
Die StrToMember-Funktion gibt das angegebene Element zurück. Die StrToMember-Funktion wird in der Regel zusammen mit benutzerdefinierten Funktionen verwendet, um eine Elementspezifikation aus einer externen Funktion an eine MDX-Anweisung zurückzugeben.
Wenn das CONSTRAINED-Flag verwendet wird, muss der Elementname direkt zu einem qualifizierten oder nicht qualifizierten Elementnamen aufgelöst werden können. Das CONSTRAINED-Flag wird verwendet, um das Risiko von Injection-Angriffen über die angegebene Zeichenfolge zu minimieren. Wenn eine Zeichenfolge bereitgestellt wird, die nicht direkt zu einem qualifizierten oder nicht qualifizierten Elementnamen aufgelöst werden kann, wird eine Fehlermeldung angezeigt, die besagt, dass die durch das CONSTRAINED-Flag in der STRTOMEMBER-Funktion vorgegebenen Einschränkungen verletzt wurden.
Wenn das CONSTRAINED-Flag nicht verwendet wird, kann das angegebene Element entweder direkt zu einem Elementnamen aufgelöst werden oder zu einem gültigen MDX-Ausdruck (Multidimensional Expressions) aufgelöst werden, der zu einem Namen aufgelöst wird.
Beispiele:
Im folgenden Beispiel wird mithilfe der StrToMember-Funktion das Reseller Sales Amount-Measure für das Bayern-Element in der State-Province-Attributhierarchie zurückgegeben. Die angegebene Zeichenfolge stellt den qualifizierten Elementnamen bereit.
SELECT StrToMember ('[Geography].[State-Province].[Bayern]')
ON 0
FROM [Adventure Works]
Im folgenden Beispiel wird mithilfe der StrToMember-Funktion das Reseller Sales Amount-Measure für das Bayern-Element zurückgegeben. Da der Elementname nur einen nicht qualifizierten Elementnamen bereitstellt, gibt die Abfrage die erste Instanz des angegebenen Elements zurück, die sich in diesem Fall in der Customer Geography-Hierarchie in der Customer-Dimension befindet, die sich nicht mit Reseller Sales überschneidet. Die bewährte Methode sieht vor, immer den qualifizierten Namen anzugeben, um erwartete Ergebnisse zu erhalten.
SELECT StrToMember ('[Bayern]').Parent
ON 0
FROM [Adventure Works]
Im folgenden Beispiel wird mithilfe der StrToMember-Funktion das Reseller Sales Amount-Measure für das Bayern-Element in der State-Province-Attributhierarchie zurückgegeben. Der bereitgestellte Elementname wird zu einem qualifizierten Elementnamen aufgelöst.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild')
ON 0
FROM [Adventure Works]
Im folgenden Beispiel wird aufgrund des CONSTRAINED-Flags ein Fehler zurückgegeben. Die bereitgestellte Elementnamen-Zeichenfolge enthält zwar einen gültigen MDX-Elementausdruck, der zu einem qualifizierten Elementnamen aufgelöst wird, das CONSTRAINED-Flag erfordert jedoch qualifizierte oder nicht qualifizierten Elementnamen in der Elementnamen-Zeichenfolge.
SELECT StrToMember ('[Geography].[Geography].[Country].[Germany].FirstChild', CONSTRAINED)
ON 0
FROM [Adventure Works]