Compartilhar via


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

Comprimento e tipo de dados

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

Eixos

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

1999

1999

2000

Hierarquia de 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 de Time

1999

1999

2000

2001

Hierarquia de 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)