Freigeben über


<xsd:group>-Element

Fasst mehrere Elementdeklarationen so zusammen, dass diese für komplexe Typdefinitionen als Gruppe eingebunden werden können.

<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>

Attribute

  • name
    Der Name der Gruppe. Der Name muss gemäß der Definition in der Spezifikation für XML-Namespaces ein NCName (Name ohne Doppelpunkt) sein.

    Dieses Attribut wird nur dann verwendet, wenn es sich bei dem schema-Element um das übergeordnete Element dieses group-Elements handelt. In diesem Fall ist group eine Modellgruppe, die von den Elementen complexType, choice und sequence verwendet wird.

    Optional.

  • id
    Die ID dieses Elements. Der id-Wert muss vom Typ ID sein und innerhalb des Dokuments, in dem dieses Element enthalten ist, eindeutig sein.

    Optional.

  • maxOccurs
    Die maximale Anzahl der Vorkommen des Elements innerhalb des enthaltenden Elements. Der Wert kann eine ganze Zahl sein, die größer oder gleich 0 (null) ist. Wenn die maximale Anzahl nach oben hin unbegrenzt sein soll, verwenden Sie die Zeichenfolge unbounded.

    Die Verwendung ist eingeschränkt, wenn die Gruppe kein untergeordnetes Element des schema-Elements ist.

    Optional.

  • minOccurs
    Die minimale Anzahl der Vorkommen des Elements innerhalb des enthaltenden Elements. Der Wert kann eine ganze Zahl sein, die größer oder gleich 0 (null) ist. Legen Sie dieses Attribut auf 0 (null) fest, um anzugeben, dass das Element optional ist.

    Die Verwendung ist eingeschränkt, wenn die Gruppe kein untergeordnetes Element des schema-Elements ist.

    Optional.

  • name
    Der Name des Elements. Der Name muss gemäß der Definition in der Spezifikation für XML-Namespaces ein NCName (Name ohne Doppelpunkt) sein. Das name-Attribut und das ref-Attribut können nicht gleichzeitig vorhanden sein.

    Erforderlich, wenn es sich bei dem enthaltenden Element um das schema-Element handelt.

    Optional.

  • ref
    Der Name einer Gruppe, die in diesem Schema deklariert ist (oder in einem sonstigen durch den betreffenden Namespace angegebenen Schema). Der ref-Wert muss ein QName sein. Das ref-Attribut kann ein Namespacepräfix enthalten.

    Wenn das ref-Attribut vorhanden ist, dürfen id, minOccurs und maxOccurs vorhanden sein. Ref und name schließen sich gegenseitig aus.

    Um eine Gruppe mithilfe einer vorhandenen Gruppendefinition zu deklarieren, geben Sie die vorhandene Gruppendefinition mithilfe des ref-Attributs an.

    <xs:group ref="globalGroup"/>
    

    Optional.

Elementinformationen

Anzahl der Vorkommen

Unbegrenzt

Übergeordnete Elemente

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

Inhalt

annotation, all, choice, sequence

Hinweise

Jedes der folgenden Elemente kann ein untergeordnetes Element des group-Elements sein.

choice

Lässt genau eines der in der Gruppe enthaltenen Elemente zu.

sequence

Legt fest, dass die Elemente der Gruppe in der angegebenen Reihenfolge auftreten müssen.

all

Ermöglicht, dass die Elemente in der Gruppe in beliebiger Reihenfolge im enthaltenden Element angezeigt bzw. nicht angezeigt werden.

Das minOccurs-Attribut und das maxOccurs-Attribut verfügen über den Standardwert 1. Eine Gruppe mit keinem der Attribute muss genau einmal im enthaltenden Element vorkommen.

Beispiel

Im folgenden Beispiel wird eine Gruppe definiert, die eine Sequenz von drei Elementen enthält. Es wird das group-Element in einer komplexen Typdefinition verwendet.

Weitere Ressourcen

Weitere Informationen finden Sie in der Spezifikation "W3C XML Schema Part 1: Structures Recommendation" unter www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all.

Siehe auch

Verweis

Referenz zu XML-Schemata (XSD)
Elemente des XML-Schemas