Elemento Axis (XMLA)

Contém um conjunto de tuplas utilizado para representar um único eixo em um conjunto de dados multidimensional contido por um elemento Axes que utiliza o tipo de dados MDDataSet, retornado pelo método Execute.

Sintaxe

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

Características do elemento

Característica	Descrição
Tipo de dados e comprimento	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-n: elemento opcional que pode ocorrer mais de uma vez.

Relações do elemento

Relação	Elemento
Elementos pai	Axes
Elementos filho	CrossProduct ou Tuples

Comentários

O conteúdo do elemento Axis varia dependendo do valor da propriedade XMLA AxisFormat utilizada pelo método Execute.

TupleFormat

Quando um aplicativo cliente definir a propriedade AxisFormat como TupleFormat, um eixo é representado como um conjunto de tuplas. Cada elemento Axis contém um elemento Tuples que representa o conjunto de tuplas naquele eixo. Cada tupla é representada usando um elemento Tuple que contém elementos Member de toda hierarquia no eixo.

ClusterFormat

Quando um aplicativo cliente define a propriedade AxisFormat como ClusterFormat, os membros de cada eixo são divididos em clusters. Cada cluster representa um produto cruzado entre conjuntos de membros ordenados a partir de cada hierarquia. Cada elemento Axis consiste em um ou mais elementos CrossProduct. Cada elemento CrossProduct contém um elemento Members para cada hierarquia no eixo.

CustomFormat

Quando um aplicativo cliente definir a propriedade AxisFormat como CustomFormat, o valor é tratado da mesma forma que o valor TupleFormat por uma instância Analysis Services.

Exemplos

Descrição

O exemplo a seguir ilustra a estrutura do elemento Axis quando um cliente especifica o TupleFormat ou o CustomFormat para a propriedade XMLA AxisFormat, fornecida aos seguintes membros do eixo:

Hierarquia Time	1999	1999	2000
Hierarquia Category	Real	Orçamento	Orçamento

Código

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

Descrição

O exemplo a seguir ilustra a estrutura dos elementos Axis quando um cliente especifica o ClusterFormat para a propriedade XMLA AxisFormat, fornecida aos seguintes membros do eixo:

Hierarquia Time	1999	1999	2000	2001
Hierarquia Category	Real	Orçamento	Orçamento	Orçamento
Clusters	Cluster 1	Cluster 1	Cluster 1	Cluster 2

Código

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

Consulte também

Conceitos

Função Properties (XMLA)