XML-Schema groupElement


XML Schema 参考手册Vollständiges XML-Schema-Referenzhandbuch

Definition und Verwendung

Das group-Element wird verwendet, um Gruppen von Elementen zu definieren, die in komplexen Typdefinitionen verwendet werden.

Elementinformationen

  • Übergeordnetes Element: schema, choice, sequence, complexType, restriction (sowohl simpleContent als auch complexContent), extension (sowohl simpleContent als auch complexContent)

Syntax

<group
id=ID
name=NCName
ref=QName
maxOccurs=nonNegativeInteger|unbounded
minOccurs=nonNegativeInteger
beliebige Attribute
>

(annotation?,(all|choice|sequence)?)

</group>

(Das ?-Zeichen gibt an, dass das group-Element null- oder einmal vorkommen kann.)

Attribute Beschreibung
id Optional. Gibt eine eindeutige ID für das Element an.
name

Optional. Gibt den Namen der Gruppe an. Dieser Name muss ein Name ohne Doppelpunkt (NCName) sein, der in der XML-Namespace-Spezifikation definiert ist.

Verwenden Sie dieses Attribut nur, wenn das schema-Element das übergeordnete Element des group-Elements ist. In diesem Fall ist die Gruppe eine Modellgruppe, die von complexType-, choice- und sequence-Elementen verwendet wird.

Das name-Attribut und das ref-Attribut dürfen nicht gleichzeitig auftreten.

ref

Optional. Verweist auf den Namen einer anderen Gruppe. Der ref-Wert muss ein QName sein. Der ref kann ein Namespace-Präfix enthalten.

Das name-Attribut und das ref-Attribut dürfen nicht gleichzeitig auftreten.

maxOccurs

Optional. Gibt die maximale Anzahl an, wie oft das Gruppenelement im übergeordneten Element vorkommen kann. Dieser Wert kann eine ganze Zahl größer oder gleich null sein. Um keine Begrenzung für die maximale Anzahl festzulegen, verwenden Sie die Zeichenfolge "unbounded". Der Standardwert ist 1.

minOccurs

Optional. Gibt die minimale Anzahl an, wie oft das Gruppenelement im übergeordneten Element vorkommen kann. Dieser Wert kann eine ganze Zahl größer oder gleich null sein. Der Standardwert ist 1.

beliebige Attribute

Optional. Gibt beliebige andere Attribute mit einem Nicht-Schema-Namespace an.

Beispiel 1

Das folgende Beispiel definiert eine Gruppe, die eine Sequenz aus vier Elementen enthält, und verwendet dieses Gruppenelement in einer komplexen Typdefinition:

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:group name="custGroup">
  <xs:sequence>
    <xs:element name="customer" type="xs:string"/>
    <xs:element name="orderdetails" type="xs:string"/>
    <xs:element name="billto" type="xs:string"/>
    <xs:element name="shipto" type="xs:string"/>
  </xs:sequence>
</xs:group>

<xs:element name="order" type="ordertype"/>

<xs:complexType name="ordertype">
  <xs:group ref="custGroup"/>
  <xs:attribute name="status" type="xs:string"/>
</xs:complexType>

</xs:schema>


XML Schema 参考手册Vollständiges XML-Schema-Referenzhandbuch Weitere Erweiterungen