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

Proprietà (XMLA)