Axis 要素 (XMLA)

  • [アーティクル]

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>

関連項目

概念

プロパティ (XMLA)