XML Schema element 元素

定义和用法

element 元素定义一个元素。

元素信息

出现次数 在架构中定义的元素的数目。
父元素 schema、choice、all、sequence
内容 simpleType、complexType、key、keyref、unique

语法

  1. <element
  2. id=ID
  3. name=NCName
  4. ref=QName
  5. type=QName
  6. substitutionGroup=QName
  7. default=string
  8. fixed=string
  9. form=qualified|unqualified
  10. maxOccurs=nonNegativeInteger|unbounded
  11. minOccurs=nonNegativeInteger
  12. nillable=true|false
  13. abstract=true|false
  14. block=(#all|list of (extension|restriction))
  15. final=(#all|list of (extension|restriction))
  16. any attributes
  17. >
  18.  
  19. annotation?,((simpleType|complexType)?,(unique|key|keyref)*))
  20.  
  21. </element>

(? 符号声明在 element 元素中,该元素可出现零次或一次,* 符号声明元素可出现零次或多次。)

属性

id

可选。规定该元素的唯一的 ID。

name

可选。规定元素的名称。如果父元素是 schema 元素,则此属性是必需的。

ref

可选。对另一个元素的引用。ref 属性可包含一个命名空间前缀。如果父元素是 schema 元素,则不是使用该属性。

type

可选。规定内建数据类型的名称,或者规定 simpleType 或 complexType 元素的名称。

substitutionGroup

可选。规定可用来替代该元素的元素的名称。 该元素必须具有相同的类型或从指定元素类型派生的类型。

如果父元素不是 schema 元素,则不可以使用该属性。

default

可选。为元素规定默认值(仅当元素内容是简单类型或 textOnly 时使用)。

fixed

可选。为元素规定固定值(仅当元素内容是简单类型或 textOnly 时使用)。

form

可选。该元素的形式。 默认值是包含该属性的 schema 元素的 elementFormDefault 属性的值。 该值必须是下列字符串之一: “qualified” 或 “unqualified”。

如果父元素是 schema 元素,则不能使用该属性。

  • 如果该值是 “unqualified”,则无须通过命名空间前缀限定该元素。
  • 如果该值是 “qualified”,则必须通过命名空间前缀限定该元素。

maxOccurs

可选。规定 element 元素在父元素中可出现的最大次数。该值可以是大于或等于零的整数。若不想对最大次数设置任何限制,请使用字符串 "unbounded"。 默认值为 1。

如果父元素是 schema 元素,则不能使用该属性。

minOccurs

可选。规定 element 元素在父元素中可出现的最小次数。该值可以是大于或等于零的整数。默认值为 1。

如果父元素是 schema 元素,则不能使用该属性。

nillable

可选。指示是否可以将显式的零值分配给该元素。此项应用于元素内容并且不是该元素的属性。 默认值为 false。

如果 nillable 为 true,将使该元素的实例可以将 nil 属性设置为 true。 nil 属性被定义为实例的 XML 架构命名空间的一部分。

例如,衔定义了单个元素,同时将 nillable 设置为 true。

  1. <xs:element name="myDate" type="xs:date" nillable="true"/>

衔使用该元素并具有显式零值(nil 属性设置为 true)。

  1. <myDate xsi:nil="true"></myDate>

abstract

可选。指示元素是否可以在实例文档中使用。如果该值为 true,则元素不能出现在实例文档中。 相反,substitutionGroup 属性包含该元素的限定名 (QName) 的其他元素必须出现在该元素的位置。多个元素可以在其 substitutionGroup 属性中引用该元素。默认值是 false。

block

可选。派生的类型。 block 属性防止具有指定派生类型的元素被用于替代该元素。该值可以包含 #all 或者一个列表,该列表是 extension、restriction 或 substitution 的子集:

  • extension - 防止通过扩展派生的元素被用来替代该元素。
  • restriction - 防止通过限制派生的元素被用来替代该元素。
  • substitution - 防止通过替换派生的元素被用来替代该元素。
  • all - 防止所有派生的元素被用来替代该元素。

final

可选。设置 element 元素上 final 属性的默认值。如果父元素不是 schema 元素,则不能使用该属性。该值可以包含 #all 或者一个列表,该列表是 extension 或 restriction 的子集:

  • extension - 防止通过扩展派生的元素被用来替代该元素
  • restriction - 防止通过限制派生的元素被用来替代该元素
  • all - 防止所有派生的元素被用来替代该元素

any attributes

可选。规定带有 non-schema 命名空间的任何其他属性。

实例

例子 1

下面的例子是一个schema,其中带有四个简单元素:"fname", "lname", "age" 以及 "dateborn",类型是 string、nonNegativeInteger 以及 date:

  1. <?xml version="1.0"?>
  2. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  3.  
  4. <xs:element name="fname" type="xs:string"/>
  5. <xs:element name="lname" type="xs:string"/>
  6. <xs:element name="age" type="xs:nonNegativeInteger"/>
  7. <xs:element name="dateborn" type="xs:date"/>
  8.  
  9. </xs:schema>

例子 2

下面的例子是一个带有复杂类型 "note" 元素的 schema。"note" 元素包含四个简单元素:"to", "from", "heading" 以及 "body":

  1. <?xml version="1.0"?>
  2. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  3.  
  4. <xs:element name="note">
  5. <xs:complexType>
  6. <xs:sequence>
  7. <xs:element name="to" type="xs:string"/>
  8. <xs:element name="from" type="xs:string"/>
  9. <xs:element name="heading" type="xs:string"/>
  10. <xs:element name="body" type="xs:string"/>
  11. </xs:sequence>
  12. </xs:complexType>
  13. </xs:element>
  14.  
  15. </xs:schema>

例子 3

本例与例子 2 相同,但是在此例中,我们选择使用 ref 属性来引用元素名称:

  1. <?xml version="1.0"?>
  2. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  3.  
  4. <xs:element name="note">
  5. <xs:complexType>
  6. <xs:sequence>
  7. <xs:element ref="to"/>
  8. <xs:element ref="from"/>
  9. <xs:element ref="heading"/>
  10. <xs:element ref="body"/>
  11. </xs:sequence>
  12. </xs:complexType>
  13. </xs:element>
  14.  
  15. <xs:element name="to" type="xs:string"/>
  16. <xs:element name="from" type="xs:string"/>
  17. <xs:element name="heading" type="xs:string"/>
  18. <xs:element name="body" type="xs:string"/>
  19.  
  20. </xs:schema>