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

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

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

在支持 XML 的对象中，列表类型属性被投影到具有子元素的元素，每个子元素都是该列表中的一项。假设名为 ColorOptions 的 IRIS 对象属性等于三个字符串的列表：“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>