row 元素 (XMLA)
包含 root 元素之資料的單一資料列,其中包含 Discover 或 Execute 方法呼叫所傳回的表格式資料。
語法
<root xmlns="urn:schemas-microsoft-com:xml-analysis:rowset">
<row>
<!-- One or more column elements -->
</row>
</root>
元素特性
特性 |
說明 |
---|---|
資料類型和長度 |
無 |
預設值 |
無 |
基數 |
0-n:出現一次以上的選擇性元素。 |
元素關聯性
關聯性 |
元素 |
---|---|
父元素 |
|
子元素 |
一個或多個資料行元素。 |
備註
包含表格式資料之 root 元素所傳回的每個資料列都具有對應的 row 元素。 root 元素中的每個資料行都由個別的 XML 元素表示。 row 元素之資料行的值是 XML 元素所包含的資料,而此資料行的名稱會對應至 XML 元素的名稱。
有兩種方式可表示資料列中資料行的 Null 值:
遺漏的資料行元素表示該資料行為 Null。
此資料行元素可能會使用 xsi:nil='true' 屬性來表示它具有 Null 值。
例如,如果資料列具有名為 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)>。