Axis 要素 (XMLA)

[アーティクル]
12/16/2008

Execute メソッドによって返される、MDDataSet データ型を使用する Axes 要素に含まれる多次元データセット内で、単一の軸を表すために使用される組のセットを含みます。

構文

<Axes>
   ...
   <Axis> <!-- when AxisFormat XMLA property is set to ClusterFormat -->
      <CrossProduct>...</CrossProduct>
   </Axis>
   <Axis> <!-- when AxisFormat XMLA property is set to TupleFormat or CustomFormat -->
      <Tuples>...</Tuples>
   </Axis>
   ...
</Axes>

要素の特性

特性	説明
データ型と長さ	なし
既定値	なし
カーディナリティ	0-n : 省略可能な要素で、出現する場合は複数回の出現が可能です

要素の関係

関係	要素
親要素	Axes
子要素	CrossProduct または Tuples

解説

Axis 要素の内容は、Execute メソッドによって使用される XMLA プロパティ AxisFormat の値に応じて異なります。

TupleFormat

クライアントアプリケーションが AxisFormat プロパティを TupleFormat に設定した場合、軸は複数の組のセットとして表されます。各 Axis 要素には、その軸上の組のセットを表す 1 つの Tuples 要素が含まれます。それぞれの組は Tuple 要素を使用して表され、この要素には軸上の各階層に属する Member 要素が含まれます。

ClusterFormat

クライアントアプリケーションが AxisFormat プロパティを ClusterFormat に設定した場合、それぞれの軸上のメンバはクラスタに分割され、各クラスタは各階層の順序付けされたメンバのセットどうしのクロス積を表します。各 Axis 要素は、1 つ以上の CrossProduct 要素から成っています。それぞれの CrossProduct 要素には、軸上の各階層に対する 1 つの Members 要素が含まれます。

CustomFormat

クライアントアプリケーションが AxisFormat プロパティを CustomFormat に設定した場合、値は Analysis Services インスタンスによって TupleFormat 値と同じように扱われます。

例

説明

次の例は、クライアントが XMLA プロパティ AxisFormat に TupleFormat または CustomFormat を指定した場合の Axis 要素の構造を示しています。ここで、軸のメンバは以下のとおりです。

Time 階層	1999	1999	2000
Category 階層	Actual	Budget	Budget

コード

<Axes>
   <Axis name="Axis0">
      <Tuples>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Actual]</UName>
               ...
            </Member>
         </Tuple>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Tuple>
         <Tuple>
            <Member Hierarchy="Time">
               <UName>[Time].[2000]</UName>
               ...
            </Member>
            <Member Hierarchy="Category">
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Tuple>
      </Tuples>
   </Axis>
   ...
</Axes>

説明

次の例は、クライアントが XMLA プロパティ AxisFormat に ClusterFormat を指定した場合の Axis 要素の構造を示しています。ここで、軸のメンバは以下のとおりです。

Time 階層	1999	1999	2000	2001
Category 階層	Actual	Budget	Budget	Budget
クラスタ	Cluster 1	Cluster 1	Cluster 1	Cluster 2

コード

<Axes>
   <Axis name="Axis0">
      <CrossProduct Size = "4">
         <Members Hierarchy="Time">
            <Member>
               <UName>[Time].[1999]</UName>
               ...
            </Member>
            <Member>
               <UName>[Time].[2000]</UName>
               ...
            </Member>
         </Members>
         <Members Hierarchy="Category">
            <Member>
               <UName>[Scenario].[Actual]</UName>
               ...
            </Member>
            <Member>
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Members>
      </CrossProduct>
      <CrossProduct Size = "1">
         <Members Hierarchy="Time">
            <Member>
               <UName>[Time].[2001]</UName>
               ...
            </Member>
         </Members>
         <Members Hierarchy="Category">
            <Member>
               <UName>[Scenario].[Budget]</UName>
               ...
            </Member>
         </Members>
      </CrossProduct>
   </Axis>
   ...
</Axes>

次の方法で共有