Partager via


Élément row (XMLA)

Contient une ligne unique de données pour un élément root contenant les données sous forme de tableau retournées par un appel de méthode Discover ou Execute.

Syntaxe

<root xmlns="urn:schemas-microsoft-com:xml-analysis:rowset">
   <row>
      <!-- One or more column elements -->
   </row>
</root>

Element Characteristics

Caractéristique

Description

Type de données et longueur

Aucun

Valeur par défaut

None

Cardinality

0-n : élément facultatif susceptible d'apparaître plusieurs fois.

Relations entre les éléments

Relation

Élément

Éléments parents

root (utilisation du type de données Rowset)

Éléments enfants

Un ou plusieurs éléments de colonne.

Notes

Chaque ligne retournée par un élément root contenant des données sous forme de tableau a un élément row correspondant. Chaque colonne dans l'élément root est représentée par un élément XML distinct. La valeur de la colonne pour l'élément row correspond aux données figurant dans l'élément XML, et le nom de la colonne correspond au nom de l'élément XML.

Il existe deux moyens d'exprimer une valeur NULL pour une colonne au sein d'une ligne :

  • Un élément de colonne manquant implique que la colonne est NULL.

  • L'élément de colonne peut utiliser l'attribut xsi:nil='true' pour indiquer qu'il possède une valeur NULL.

Par exemple, si une ligne comporte une seule colonne appelée Store_Name, dont la valeur est NULL, elle peut être représentée des deux façons suivantes :

<row>
</row>

- ou -

   <row>
      <Store_name xsi:nil='true'/>
   </row>

Si un élément de colonne contient une erreur, un élément Error fournit des informations à propos de cette erreur, comme le décrit l'exemple suivant :

<row>   <Store_name>
      <Error xmlns="urn:schemas-microsoft-com:xml-analysis:exception">
         <ErrorCode>3238658054</ErrorCode>
         <Description>The object [X] was not found in the cube when [X] was parsed.</Description>
      </Error>
   </Store_name>
</row>

Pour obtenir plus d'informations sur l'affectation de noms aux colonnes et des informations de schéma pour les données sous forme de tableau, consultez Type de données Rowset (XMLA).

Voir aussi

Concepts

Properties (XMLA)