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