StrToTuple （MDX）
傳回多維度運算式 （MDX） 格式字串所指定的 Tuple。
語法
StrToTuple(Tuple_Specification [,CONSTRAINED] )
引數
Tuple_Specification
直接或間接指定 Tuple 的有效字串運算式。
備註
StrToTuple 函式 會傳回指定的集合。 StrToTuple 函式通常與使用者定義的函式搭配使用，以將 Tuple 規格從外部函式傳回 MDX 語句。
使用 CONSTRAINED 旗標時，Tuple 規格必須包含限定或未限定的成員名稱。 此旗標可用來降低透過指定字串進行插入式攻擊的風險。 如果提供的字串無法直接解析為限定或未限定的成員名稱，則會出現下列錯誤：「違反 STRTOTUPLE 函式中 CONSTRAINED 旗標的限制。
未使用 CONSTRAINED 旗標時，指定的 Tuple 可以解析為傳回 Tuple 的有效 MDX 運算式。
範例
下列範例會傳回 2004 年日曆年度拜仁成員的 Reseller Sales Amount 量值。 提供的 Tuple 規格包含有效的 MDX Tuple 運算式。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
下列範例會傳回 2004 年日曆年度拜仁成員的 Reseller Sales Amount 量值。 提供的 Tuple 規格包含限制旗標所需的限定成員名稱。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]
下列範例會傳回 2004 年日曆年度拜仁成員的 Reseller Sales Amount 量值。 提供的 Tuple 規格包含有效的 MDX Tuple 運算式。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
下列範例會因為 CONSTRAINED 旗標而傳回錯誤。 雖然提供的 Tuple 規格包含有效的 MDX Tuple 運算式，但 CONSTRAINED 旗標需要 Tuple 規格中限定或未限定的成員名稱。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]