<xsd:element> 元素

声明一个元素。

<element
  abstract = Boolean : false
  block = (#all | List of (extension | restriction | substitution))
  default = string
  final = (#all | List of (extension | restriction))
  fixed = string
  form = (qualified | unqualified)
  id = ID
  maxOccurs = (nonNegativeInteger | unbounded) : 1
  minOccurs = nonNegativeInteger : 1
  name = NCName
  nillable = Boolean : false
  ref = QName
  substitutionGroup = QName
  type = QName
  {any attributes with non-schema Namespace}...>
Content: (annotation?, ((simpleType | complexType)?, (unique | key |
keyref)*))
</element>

特性

• abstract
  一个指示符，指示元素是否可以在实例文档中使用。 如果该值为 true，则元素不能出现在实例文档中。 而 substitutionGroup 属性包含该元素的限定名 (QName) 的其他元素必须出现在该元素的位置。 多个元素可以在其 substitutionGroup 属性中引用该元素。

  默认值为 false。

  可选。

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

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

  可选。

• default
  如果元素内容是简单类型或者元素内容是 textOnly，则为元素的默认值。

  fixed 和 default 属性相互排斥。

  如果元素包含简单类型，则该值必须是该类型的有效值。

  可选。

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

  如果引用的元素是在全局级别声明的（父元素是 schema 元素），则可以在任何元素上使用该属性。

  该值必须是 QName。

  可选。

• final
  派生的类型。 final 属性在 element 元素上设置 final 属性的默认值。 该值可以包含 #all 或者一个列表，该列表是 extension 或 restriction 的子集。

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

  如果包含元素不是 schema 元素，则会被禁止。

  可选。

• fixed
  如果元素的内容是简单类型或其内容是 textOnly，则为该元素的预确定的、不可更改的值。

  fixed 和 default 属性相互排斥。

  可选。

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

  如果该值是非限定的，则无须通过命名空间前缀限定该元素。

  如果该值是限定的，则必须通过命名空间前缀限定该元素。

  可选。

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

  可选。

• maxOccurs
  该元素可以在包含元素中出现的最大次数。 该值可以是大于或等于零的整数。 若不想对最大次数设置任何限制，请使用字符串“unbounded”。

  如果包含元素为 schema 元素，则会被禁止。

  可选。

• minOccurs
  该元素可以在包含元素中出现的最少次数。 该值可以是大于或等于零的整数。 若要指定该元素是可选的，请将此特性设置为零。

  如果包含元素为 schema 元素，则会被禁止。

  可选。

• name
  元素的名称。 该名称必须是在 XML 命名空间规范中定义的无冒号名称 (NCName)。 Name 和 ref 属性不能同时出现。

  如果包含元素是 schema 元素，则是必选项。

  可选。

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

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

  例如，下段定义了单个元素，同时将 nillable 设置为 true。

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

  下段使用该元素并具有显式零值（nil 属性设置为 true）。

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

  可选。

• ref
  在此架构（或者由指定命名空间指示的其他架构）中声明的元素的名称。 ref 值必须是 QName。 ref 可以包含命名空间前缀。

  如果包含元素为 schema 元素，则会被禁止。

  如果 ref 属性出现，则 complexType、simpleType、key、keyref 和 unique 元素以及 nillable、default、fixed、form、block 和 type 属性不能出现。

  <xs:element ref="comment"/>
  

  可选。

• type
  或者是内置数据类型的名称，或者是在此架构（或者由指定命名空间指示的其他架构）中定义的 simpleType 或 complexType 元素的名称。 提供的值必须与引用的 simpleType 或 complexType 元素上的 name 属性相对应。

  type 和 ref 属性是互相排斥的。

  若要使用现有简单类型或复杂类型定义声明一个元素，请使用 type 属性指定现有类型。

  <xs:element name="name" type="xs:string"/>
  

  可选。

元素信息

备注

元素声明将名称与类型定义关联，类型定义可以是内置数据类型、简单类型或复杂类型。

元素声明可以作为 schema 元素（具有全局范围）的子元素存在或在复杂类型定义内存在。 在复杂类型内，元素声明可以作为本地声明或对具有全局范围的元素的引用存在。

全局元素声明必须直接定义复杂类型。

只有在 ref 和 type 属性均不存在时，simpleType 或 complexType 元素才可以作为子元素存在。

此外，元素可以通过在 choice、all、sequence 和 complexType 元素内的引用出现。

示例

以下示例包含两个元素，这两个元素可以彼此替代。

其他资源

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

另请参见

参考

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