Condividi tramite


Elemento Axis (XMLA)

Contiene un set di tuple utilizzato per rappresentare un singolo asse in un dataset multidimensionale contenuto in un elemento Axes che utilizza il tipo di dati MDDataSet, restituito dal metodo Execute.

Sintassi

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

Caratteristiche elemento

Caratteristica

Descrizione

Tipo di dati e lunghezza

Nessuno

Valore predefinito

Nessuno

Cardinalità

0-n: elemento facoltativo che può ricorrere più di una volta.

Relazioni elemento

Relazione

Elemento

Elementi padre

Axes

Elementi figlio

CrossProduct o Tuples

Osservazioni

Il contenuto dell'elemento Axis varia a seconda del valore della proprietà XMLA AxisFormat utilizzata dal metodo Execute.

TupleFormat

Quando un'applicazione client imposta la proprietà AxisFormat su TupleFormat, un asse viene rappresentato come un set di tuple. Ogni elemento Axis contiene un elemento Tuples che rappresenta il set di tuple sull'asse. Ogni tupla viene rappresentata utilizzando un elemento Tuple che contiene elementi Member di ogni gerarchia sull'asse.

ClusterFormat

Quando un'applicazione client imposta la proprietà AxisFormat su ClusterFormat, i membri su ogni asse vengono divisi in cluster, dove ogni cluster rappresenta un prodotto incrociato tra insiemi ordinati di membri di ogni gerarchia. Ogni elemento Axis è costituito da uno o più elementi CrossProduct. Ogni elemento CrossProduct contiene un elemento Members per ogni gerarchia sull'asse.

CustomFormat

Quando un'applicazione client imposta la proprietà AxisFormat su CustomFormat, il valore viene trattato analogamente al valore TupleFormat da un'istanza di Analysis Services.

Esempi

Descrizione

Nell'esempio seguente viene illustrata la struttura degli elementi Axis quando un client specifica TupleFormat o CustomFormat per la proprietà XMLA AxisFormat, presupponendo i membri seguenti per l'asse:

Gerarchia Time

1999

1999

2000

Gerarchia Category

Actual

Budget

Budget

Codice

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

Descrizione

Nell'esempio seguente viene illustrata la struttura degli elementi Axis quando un client specifica ClusterFormat per la proprietà XMLA AxisFormat, presupponendo i membri seguenti per l'asse:

Gerarchia Time

1999

1999

2000

2001

Gerarchia Category

Actual

Budget

Budget

Budget

Cluster

Cluster 1

Cluster 1

Cluster 1

Cluster 2

Codice

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

Vedere anche

Concetti