通过

<xsd:key> 元素

指定属性或元素值（或一组值）必须是指定范围内的键。 键的范围为实例文档中的包含 element。 键意味着数据在指定范围内应是唯一的、不为零的并且始终存在的。

<key
  id = ID 
  name = NCName 
  {any attributes with non-schema Namespace}...>
Content: (annotation?, (selector, field+))
</key>

属性

  • id
    该元素的 ID。 id 值必须属于类型 ID 并且在包含该元素的文档中是唯一的。

    可选项。

  • name
    key 元素的名称。 该名称必须是在 XML 命名空间规范中定义的无冒号名称 (NCName)。

    该名称在标识约束集中必须是唯一的。

    必选项。

元素信息

出现次数

无限制

父元素

element

内容

annotation、field、selector

备注

key 元素必须按顺序包含下列元素。

selector

selector 元素包含 XML 路径语言 (XPath) 表达式，指定一个元素集，在其中由字段指定的值必须唯一。

必须有一个且只有一个 selector 元素。

字段

每一个 field 元素均包含一个 XPath 表达式，它指定对于由 selector 元素指定的元素集而言必须唯一的值（属性或元素值）。

如果有多个 field 元素，则 field 元素的组合必须是唯一的。 在此情况下，单个 field 元素的值对于选定元素不一定是唯一的，但所有字段的组合必须是唯一的。

必须有一个或多个 field 元素。

示例

以下示例定义 keyref 元素，该元素与此架构中的 key 元素相对应。

<xs:schema 
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
   targetNamespace="namespace1"
        xmlns:r="namespace1"
        elementFormDefault="qualified">

 <xs:element name="root">
  <xs:complexType>
   <xs:sequence>

    <xs:element name="A" type="r:A" maxOccurs="unbounded">
     <xs:keyref name="dummy" refer="r:pNumKey">
      <xs:selector xpath="part"/>
      <xs:field xpath="@ref-number"/>
     </xs:keyref>
    </xs:element>

    <xs:element name="B" type="r:B"/>

   </xs:sequence>
  </xs:complexType>

  <xs:key name="pNumKey">
   <xs:selector xpath="r:B/r:part"/>
   <xs:field xpath="@key-number"/>
  </xs:key>

  </xs:element>

 <xs:complexType name="A">
  <xs:sequence>
   <xs:element name="part" maxOccurs="unbounded">
    <xs:complexType>
     <xs:simpleContent>
      <xs:extension base="xs:string">
       <xs:attribute name="ref-number" type="xs:integer"/>
      </xs:extension>
     </xs:simpleContent>
    </xs:complexType>
   </xs:element>
  </xs:sequence>
 </xs:complexType>

 <xs:complexType name="B">
  <xs:sequence>
   <xs:element name="part" maxOccurs="unbounded">
    <xs:complexType>
     <xs:simpleContent>
      <xs:extension base="xs:string">
       <xs:attribute name="key-number" type="xs:integer"/>
      </xs:extension>
     </xs:simpleContent>
    </xs:complexType>
   </xs:element>
  </xs:sequence>
 </xs:complexType>

</xs:schema>

输入： key.xml

<root xmlns="namespace1">
  <A>
    <!-- if the ref-number is not equal to one of the key-number, the validation will give error -->
    <part ref-number="1"/>
  </A>
  <A>
    <!-- if the ref-number is not equal to one of the key-number, the validation will give error -->
    <part ref-number="2"/>
  </A>
  <B>
    <part key-number="1"/>
    <part key-number="2"/>
    <part key-number="3"/>
  </B>
</root>

其他资源

有关更多信息，请参见“W3C XML Schema Part 1: Structures Recommendation”（W3C XML 架构第 1 部分：结构建议），网址为 www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all。

另请参见

参考

XML 架构 (XSD) 参考
XML 架构元素