Elemento Axis (XMLA)

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

Syntax

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

Relação	Elemento
Elementos pai	Eixos
Elementos filho	CrossProduct ou tuplas

Comentários

O conteúdo do elemento Axis varia dependendo do valor da propriedade XMLA AxisFormat usada 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 nesse 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 em cada eixo são divididos em clusters, nos quais cada cluster representa um produto cruzado entre conjuntos ordenados de membros 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 define a propriedade AxisFormat como CustomFormat, o valor é tratado da mesma forma que o valor de TupleFormat por uma instância de Analysis Services.

Exemplos

Descrição

O exemplo a seguir ilustra a estrutura dos elementos Axis quando um cliente especifica TupleFormat ou CustomFormat para a propriedade XMLA AxisFormat , considerando os seguintes membros para o eixo:

Hierarquia de tempo

Hierarquia de categoria

1999

Real

1999

Orçamento

2000

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 de eixo quando um cliente especifica ClusterFormat para a propriedade XMLA AxisFormat , considerando os seguintes membros para o eixo:

Hierarquia de tempo

Hierarquia de categoria

Clusters

1999

Real

Clusters 1

1999

Orçamento

Clusters 1

2000

Orçamento

Clusters 1

2001

Orçamento

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