第二十章 控制 XML 元素和属性名称 - 控制列表类型属性的元素和属性名称

控制列表类型属性的元素和属性名称

注意:本节不适用于将 XMLPROJECTION 指定为“ELEMENT”的集合属性。对于这样的属性,每个列表项都被视为该类的单独属性。

在支持 XML 的对象中,列表类型属性被投影到具有子元素的元素,每个子元素都是该列表中的一项。假设名为 ColorOptionsIRIS 对象属性等于三个字符串的列表:“Red”、“Green”、“Blue”。默认情况下,该属性对应于以下 XML 片段:

<ColorOptions>
  <ColorOptionsItem>Red</ColorOptionsItem>
  <ColorOptionsItem>Green</ColorOptionsItem>
  <ColorOptionsItem>Blue</ColorOptionsItem>
</ColorOptions>

这显示了 ColorOptionsItem 子元素,它对应于列表中的一个项目。该子元素的名称确定如下:

相同的逻辑适用于数组的项目。数组的键是单独处理的。

控制数组类型属性的元素和属性名称

注意:本节不适用于将 XMLPROJECTION 指定为“ELEMENT”的集合属性。对于这样的属性,每个数组项都被视为该类的单独属性。请参阅控制集合属性的投影。

在支持 XML 的对象中,数组类型属性被投影到具有子元素的元素,每个子元素都是该数组中的一项,其基本方式与投影列表属性相同;请参阅上一节。

每个子元素都有一个附加属性,指示与该项目关联的键。可以控制该属性的名称。

考虑以下示例属性:

Property Tools As %ArrayOfDataTypes;

例如,假设(对于某些对象实例)此属性由一个数组组成,如下所示:

  • Hammer 值与密钥 845 一起存储。
  • Monkey wrench与密钥 1009 一起存储。
  • Screwdriver 与密钥 3762 一起存储。

默认情况下,该属性对应于以下 XML 片段:

<Tools>
  <ToolsItem ToolsKey="845">Hammer</ToolsItem>
  <ToolsItem ToolsKey="1009">Monkey Wrench</ToolsItem>
  <ToolsItem ToolsKey="3762">Screwdriver</ToolsItem>
</Tools>

这显示了 ToolsKey 属性,它对应于数组的键。该属性的名称确定如下:

请注意,XMLITEMNAME 属性参数不会影响属性名称;它会影响属性名称。该参数已在上一节中讨论过。

例如,假设未设置 XMLKEYNAME,并将 XMLNAME 设置为等于 MyXMLName,如下所示:

Property Tools As %ArrayOfDataTypes(XMLNAME = "MyXMLName");

那么相同的属性将对应于以下 XML片段:

<MyXMLName>
  <MyXMLNameItem MyXMLNameKey="845">Hammer</MyXMLNameItem>
  <MyXMLNameItem MyXMLNameKey="1009">Monkey Wrench</MyXMLNameItem>
  <MyXMLNameItem MyXMLNameKey="3762">Screwdriver</MyXMLNameItem>
</MyXMLName>
12-01 22:13