Article
09/27/2010

Élément CellInfo (XMLA)

Représente les métadonnées de cellule que contient l'élément parent OlapInfo.

Syntaxe

<OlapInfo>
   ...
   <CellInfo>
      <!-- One or more cell property definitions -->
   </CellInfo>
   ...
</OlapInfo>

Caractéristiques de l'élément

Caractéristique	Description
Type de données et longueur	Aucun
Valeur par défaut	Aucune
Cardinalité	1-1 : élément requis qui apparaît une fois et une seule.

Relations entre les éléments

Relation	Élément
Éléments parents	OlapInfo
Éléments enfants	Une ou plusieurs définitions de propriété de cellule

Notes

L'élément CellInfo contient une collection de propriétés de cellule pour les cellules incluses dans le dataset multidimensionnel retourné par un élément root à l'aide du type de données MDDataSet. Chaque propriété de cellule dans l'élément CellInfo est définie par un élément XML distinct, chacune avec un attribut name et un attribut type. L'attribut name de la propriété de cellule correspond au nom de la propriété de cellule OLE DB pour OLAP représentée par l'élément XML et l'attribut type représente le type de données XML de la propriété de cellule. Le nom de l'élément XML permet d'identifier la valeur de la propriété de cellule pour les cellules contenues dans l'élément CellData de l'élément root.

La syntaxe suivante décrit une définition de propriété de cellule :

<CellPropertyDefinition name="string" type"string" />

Les propriétés disponibles et leurs valeurs peuvent être obtenues via le type de demande DISCOVER_PROPERTIES avec la méthode Discover. Il n'existe aucun ordre requis pour les propriétés répertoriées dans l'élément PropertyList.

Un fournisseur peut éventuellement spécifier des valeurs par défaut pour des propriétés de cellule ou de membre individuelles dans la section AxisInfo ou CellInfo. Les valeurs par défaut peuvent fournir un résultat plus restreint si la propriété affiche toujours, ou presque, la même valeur. Pour indiquer la valeur par défaut d'une propriété, l'élément Default peut éventuellement être spécifié en tant qu'élément enfant de l'un des éléments de la définition de propriété de cellule. Par conséquent, l'absence d'une propriété de membre ou de cellule dans le résultat signifie que la valeur indiquée par défaut correspond à la valeur de la propriété de cellule.

Exemple

L'exemple suivant illustre comment les propriétés de cellule VALUE, FORMATTED_VALUE et FORMAT_STRING sont représentées dans l'élément CellInfo.

<OlapInfo>
   ...
      <CellInfo>
         <Value name="VALUE"></Value>
         <FmtValue name="FORMATTED_VALUE"></FmtValue>
         <FormatString name="FORMAT_STRING"></FormatString>
      </CellInfo>
</OlapInfo>

Voir aussi

Concepts

Properties (XMLA)

Share via