<xsd:element>-Element

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

Attribute

• abstract
  Ein Indikator dafür, ob das Element in einem Instanzdokument verwendet werden kann. Wenn dieser Wert true ist, kann das Element nicht im Instanzdokument enthalten sein. Stattdessen muss ein anderes Element verwendet werden, dessen substitutionGroup-Attribut den qualifizierten Namen (QName) des betreffenden Elements enthält. Auf dieses Element kann über das substitutionGroup-Attribut von mehreren Elementen aus verwiesen werden.

  Der Standardwert ist false.

  Optional.

• block
  Der Typ der Ableitung. Das block-Attribut verhindert, dass ein Element mit dem angegebenen Ableitungstyp anstelle dieses Elements verwendet wird. Der Wert kann #all bzw. eine Liste enthalten, die eine Teilmenge von extension, restriction oder substitution darstellt.

  extension	Verhindert, dass durch Erweiterung abgeleitete Elemente anstelle dieses Elements verwendet werden.
  restriction	Verhindert, dass durch Einschränkung abgeleitete Elemente anstelle dieses Elements verwendet werden.
  substitution	Verhindert, dass durch Ersetzung abgeleitete Elemente anstelle dieses Elements verwendet werden.
  #all	Verhindert, dass alle abgeleiteten Elemente anstelle dieses Elements verwendet werden.

  Optional.

• default
  Der Standardwert des Elements, sofern dessen Inhalt als einfacher Typ oder als textOnly-Element definiert ist.

  Das fixed-Attribut und das default-Attribut schließen einander gegenseitig aus.

  Wenn das Element einen einfachen Typ enthält, muss es sich bei diesem Wert um einen gültigen Wert dieses Typs handeln.

  Optional.

• substitutionGroup
  Der Name eines Elements, durch das dieses Element ersetzt werden kann. Der Typ dieses Elements muss mit dem Typ des angegebenen Elements identisch oder von diesem abgeleitet sein.

  Dieses Attribut kann für ein beliebiges Element verwendet werden, sofern das verweisende Element auf globaler Ebene deklariert ist (das übergeordnete Element ist ein schema-Element).

  Dieser Wert muss ein QName sein.

  Optional.

• final
  Der Typ der Ableitung. Das final-Attribut legt den Standardwert des final-Attributs für das element-Element fest. Der Wert kann #all bzw. eine Liste enthalten, die eine Teilmenge von extension oder restriction darstellt.

  extension	Verhindert, dass durch Erweiterung abgeleitete Elemente anstelle dieses Elements verwendet werden.
  restriction	Verhindert, dass durch Einschränkung abgeleitete Elemente anstelle dieses Elements verwendet werden.
  #all	Verhindert, dass alle abgeleiteten Elemente anstelle dieses Elements verwendet werden.

  Wenn es sich bei dem enthaltenden Element nicht um das schema-Element handelt, ist dieses Attribut unzulässig.

  Optional.

• fixed
  Der vordefinierte, unveränderliche Wert des Elements, sofern dessen Inhalt als einfacher Typ oder als textOnly-Element definiert ist.

  Das fixed-Attribut und das default-Attribut schließen einander gegenseitig aus.

  Optional.

• form
  Das Formular für das Element. Der Standardwert ist der Wert des elementFormDefault-Attributs des schema-Elements, das das Attribut enthält. Der Wert muss einer der folgenden Zeichenfolgen entsprechen: "qualified" oder "unqualified".

  Beim Wert unqualified muss dieses Element nicht mit dem Namespacepräfix gekennzeichnet sein.

  Beim Wert qualified muss dieses Element mit dem Namespacepräfix gekennzeichnet sein.

  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.

  Nicht zulässig, wenn es sich bei dem enthaltenden Element um das schema-Element handelt.

  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.

  Nicht zulässig, wenn es sich bei dem enthaltenden Element um das schema-Element handelt.

  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.

• nillable
  Der Indikator dafür, ob dem Element ein expliziter NULL-Wert zugewiesen werden kann. Das gilt für den Elementinhalt und nicht für die Attribute des Elements. Der Standardwert ist false.

  Wenn nillable true ist, kann das nil-Attribut einer Instanz des Elements auf true festgelegt werden. Das nil-Attribut ist als Teil des XML-Schemanamespaces für Instanzen definiert.

  So definiert das nachstehende Codefragment ein einzelnes Element, dessen nillable-Attribut auf true festgelegt ist.

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

  Im folgenden Fragment wird dieses Element mit einem expliziten NULL-Wert (nil-Attribut ist auf true festgelegt) verwendet.

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

  Optional.

• ref
  Der Name eines Elements, das in diesem Schema definiert 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.

  Nicht zulässig, wenn es sich bei dem enthaltenden Element um das schema-Element handelt.

  Wenn das ref-Attribut vorhanden ist, sind die Elemente complexType, simpleType, key, keyref und unique sowie die Attribute nillable, default, fixed, form, block und type nicht zulässig.

  <xs:element ref="comment"/>
  

  Optional.

• type
  Entweder der Name eines integrierten Datentyps oder der Name eines simpleType-Elements oder eines complexType-Elements, das in diesem Schema (oder in einem anderen vom angegebenen Namespace bestimmten Schema) definiert ist. Der angegebene Wert muss dem name-Attribut für das simpleType- oder das complexType-Element entsprechen, auf das verwiesen wird.

  Das type-Attribut und das ref-Attribut schließen einander gegenseitig aus.

  Um ein Element mithilfe einer vorhandenen Definition für einen einfachen oder komplexen Typ zu deklarieren, geben Sie den vorhandenen Typ mithilfe des type-Attributs an.

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

  Optional.

Elementinformationen

Hinweise

Eine Elementdeklaration ordnet einen Namen einer Typdefinition zu. Dabei kann es sich um einen integrierten Datentyp, einen einfachen Typ oder einen komplexen Typ handeln.

Elementdeklarationen können als untergeordnete Elemente des schema-Elements (mit einem globalen Gültigkeitsbereich) oder innerhalb von Definitionen komplexer Typen vorhanden sein. Innerhalb von komplexen Typen können Elementdeklarationen als lokale Deklarationen oder Verweise auf Elemente mit globalem Gültigkeitsbereich vorhanden sein.

Deklarationen globaler Elemente müssen komplexe Typen direkt definieren.

Ein simpleType-Element oder ein complexType-Element ist als untergeordnetes Element nur dann zulässig, wenn sowohl das ref-Attribut als auch das type-Attribut nicht vorhanden sind.

Darüber hinaus können Elemente per Verweis innerhalb der Elemente choice, all, sequence und complexType aufgeführt sein.

Beispiele

Das folgende Beispiel enthält zwei Elemente, die als Ersatz für ein anderes Element verwendet werden können.

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