通过

<xsd:group> 元素

将若干元素声明归为一组，以便将它们当作一个组并入复杂类型定义。

<group
  name= NCName
  id = ID
  maxOccurs = (nonNegativeInteger | unbounded) : 1
  minOccurs = nonNegativeInteger : 1
  name = NCName
  ref = QName
  {any attributes with non-schema Namespace}...>
Content: (annotation?, (all | choice | sequence))
</group>

属性

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

    仅当 schema 元素是该 group 元素的父元素时才使用该属性。 在此情况下，group 是由 complexType、choice 和 sequence 元素使用的模型组。

    可选项。

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

    可选项。

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

    当该组不是 schema 元素的子级时，将受到限制。

    可选项。

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

    当该组不是 schema 元素的子级时，将受到限制。

    可选项。

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

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

    可选项。

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

    如果 ref 属性出现，则 id、minOccurs 和 maxOccurs 可以出现。 Ref 和 name 是互相排斥的。

    若要使用现有组定义声明一个组，请使用 ref 属性指定现有组定义。

    <xs:group ref="globalGroup"/>

    可选项。

元素信息

出现次数

无限制

父元素

schema、choice、sequence、complexType、restriction (complexContent)、extension (complexContent)

内容

annotation、all、choice、sequence

备注

以下各元素中的任何一个元素都可以是 group 元素的子元素。

choice

允许在组内包含元素之一且只能包含一个。

sequence

要求组中的元素以指定顺序显示。

all

允许组中的元素以任意顺序显示（或不显示）在包含元素中。

minOccurs 和 maxOccurs 属性的默认值为 1。 没有这两个属性的组在包含元素中必须出现一次并且只能出现一次。

示例

以下示例定义一个包含三个元素的序列的组并且在复杂类型定义中使用 group 元素。

<xs:element name="thing1" type="xs:string"/>
<xs:element name="thing2" type="xs:string"/>
<xs:element name="thing3" type="xs:string"/>

<xs:attribute name="myAttribute" type="xs:decimal"/>

<xs:group name="myGroupOfThings">
 <xs:sequence>
  <xs:element ref="thing1"/>
  <xs:element ref="thing2"/>
  <xs:element ref="thing3"/>
 </xs:sequence>
</xs:group>

<xs:complexType name="myComplexType">
  <xs:group ref="myGroupOfThings"/>
  <xs:attribute ref="myAttribute"/>
</xs: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 架构元素