回傳由 Multidimensional Expressions（MDX）格式字串指定的元組。
Syntax
StrToTuple(Tuple_Specification [,CONSTRAINED] )
論點
Tuple_Specification
一個有效的字串表達式，直接或間接指定一個元組。
備註
StrToTuple 函式回傳指定的集合。 StrToTuple 函式通常與使用者自訂函式一起使用，用以將外部函式的元組規格回傳回 MDX 語句。
當使用 CONSTRAINED 旗標時，元組規範必須包含合格或不限定的成員名稱。 此旗標用來降低透過指定字串引發注入攻擊的風險。 若提供字串無法直接解析至合格或不限定成員名稱，則會出現以下錯誤：「STRTOTUPLE 函式中 CONSTRAINED 標誌所施加的限制已被違反。」
當未使用限制旗標時，指定的元組可解析為有效的 MDX 表達式，回傳元組。
Examples
以下範例回傳拜仁會員在2004年曆年的經銷商銷售金額指標。 所提供的元組規範包含有效的 MDX 元組表達式。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
以下範例回傳拜仁會員在2004年曆年的經銷商銷售金額指標。 所提供的元組規範包含符合限制標誌要求的合格成員名稱。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].[CY 2004], [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]
以下範例回傳拜仁會員在2004年曆年的經銷商銷售金額指標。 所提供的元組規範包含有效的 MDX 元組表達式。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])')
ON 0
FROM [Adventure Works]
以下範例因 CONSTRAINED 標誌而回傳錯誤。 雖然所提供的元組規範包含有效的 MDX 元組表達式，但 CONSTRAINED 標誌要求元組規範中包含合格或非限定的成員名稱。
SELECT StrToTuple ('([Geography].[State-Province].[Bayern],[Date].[Calendar Year].&[2003].NEXTMEMBER, [Measures].[Reseller Sales Amount])', CONSTRAINED)
ON 0
FROM [Adventure Works]