Axis 要素 (XMLA)

Execute メソッドによって返される MDDataSet データ型を使用する Axes 要素に含まれる多次元データセット内の 1 つの軸を表すタプルのセットが含まれます。

構文

  
<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 : 省略可能な要素で、出現する場合は複数回の出現が可能です

要素リレーションシップ

リレーションシップ 要素
親要素 軸
子要素 CrossProduct または Tuples

注釈

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

TupleFormat

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

ClusterFormat

クライアント アプリケーションが AxisFormat プロパティを ClusterFormat に設定すると、各軸のメンバーはクラスターに分割されます。各クラスターは、各階層のメンバーの順序付けされたセット間のクロス製品を表します。 各 Axis 要素 は、1 つ以上の CrossProduct 要素で構成 されます。 すべての CrossProduct 要素 には、軸上の階層ごとに Members 要素が含まれています。

CustomFormat

クライアント アプリケーションが AxisFormat プロパティを CustomFormat に設定すると、値はインスタンスによって TupleFormat 値とAnalysis Servicesされます。

例

説明

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

Time 階層

Category 階層

1999

Actual

1999

予算

2000

予算

コード

<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>  

説明

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

Time 階層

Category 階層

クラスター

1999

Actual

クラスター 1

1999

予算

クラスター 1

2000

予算

クラスター 1

2001

予算

クラスター 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>