row 元素 (XMLA)

包含单行 root 元素的数据,该元素包含有 DiscoverExecute 方法调用返回的表格格式数据。

语法

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

元素特征

特征

说明

数据类型和长度

默认值

基数

0-n:可多次出现的可选元素。

元素关系

关系

元素

父元素

root (使用 Rowset 数据类型)

子元素

一个或多个列元素。

注释

包含表格格式数据的 root 元素所返回的每一行都有一个相应的 row 元素。root 元素中的每列都由单个 XML 元素表示。row 元素的列值为 XML 元素包含的数据,该列的名称与 XML 元素的名称对应。

有两种方法可表示行中的列的空值:

  • 缺少列元素意味着该列为空。

  • 列元素可以使用 xsi:nil='true' 属性指示自己具有空值。

例如,如果某行具有名为 Store_Name 的列,且该列的值为 NULL,则它可以通过以下两种方法之一表示:

<row>
</row>

或:

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

如果列元素包含错误,则 Error 元素可提供有关该错误的信息,如下面的示例所示:

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

有关列命名和表格格式数据的架构的信息,请参阅Rowset 数据类型 (XMLA)

请参阅

概念