XML Schema elementElement
Vollständiges XML-Schema-Referenzhandbuch
Definition und Verwendung
Das Element element definiert ein Element.
Elementinformationen
- Übergeordnetes Element: schema, choice, all, sequence, group
Syntax
id=ID
name=NCName
ref=QName
type=QName
substitutionGroup=QName
default=string
fixed=string
form=qualified|unqualified
maxOccurs=nonNegativeInteger|unbounded
minOccurs=nonNegativeInteger
nillable=true|false
abstract=true|false
block=(#all|list of (extension|restriction))
final=(#all|list of (extension|restriction))
beliebige Attribute
>
annotation?,(simpleType|complexType)?,(unique|key|keyref)*
</element>
(Das Symbol ? gibt an, dass das Element null- oder einmal innerhalb des Elements element auftreten kann; das Symbol * gibt an, dass das Element null- oder mehrmals auftreten kann.)
| Attribute | Beschreibung |
|---|---|
| id | Optional. Gibt eine eindeutige ID für das Element an. |
| name | Optional. Gibt den Namen des Elements an. Wenn das übergeordnete Element das schema-Element ist, ist dieses Attribut erforderlich. |
| ref | Optional. Eine Referenz auf ein anderes Element. Das Attribut ref kann ein Namespace-Präfix enthalten. Dieses Attribut wird nicht verwendet, wenn das übergeordnete Element das schema-Element ist. |
| type | Optional. Gibt den Namen eines integrierten Datentyps oder den Namen eines simpleType- oder complexType-Elements an. |
| substitutionGroup | Optional. Gibt den Namen eines Elements an, das als Ersatz für dieses Element verwendet werden kann. Dieses Element muss denselben Typ oder einen vom angegebenen Elementtyp abgeleiteten Typ haben. Dieses Attribut kann nicht verwendet werden, wenn das übergeordnete Element nicht das schema-Element ist. |
| default | Optional. Gibt einen Standardwert für das Element an (wird nur verwendet, wenn der Elementinhalt ein einfacher Typ oder textOnly ist). |
| fixed | Optional. Gibt einen festen Wert für das Element an (wird nur verwendet, wenn der Elementinhalt ein einfacher Typ oder textOnly ist). |
| Form | Optional. Die Form des Elements. Der Standardwert ist der Wert des elementFormDefault-Attributs des schema-Elements, das dieses Attribut enthält. Der Wert muss einer der folgenden Strings sein: "qualified" oder "unqualified". Wenn das übergeordnete Element das schema-Element ist, kann dieses Attribut nicht verwendet werden.
|
| maxOccurs | Optional. Gibt an, wie oft das element-Element im übergeordneten Element maximal vorkommen kann. Der Wert kann eine ganze Zahl größer oder gleich null sein. Um kein Limit für die maximale Anzahl festzulegen, verwenden Sie die Zeichenfolge "unbounded". Der Standardwert ist 1. Wenn das übergeordnete Element das schema-Element ist, kann dieses Attribut nicht verwendet werden. |
| minOccurs | Optional. Gibt an, wie oft das element-Element im übergeordneten Element mindestens vorkommen kann. Der Wert kann eine ganze Zahl größer oder gleich null sein. Der Standardwert ist 1. Wenn das übergeordnete Element das schema-Element ist, kann dieses Attribut nicht verwendet werden. |
| nillable | Optional. Gibt an, ob dem Element ein expliziter nil-Wert zugewiesen werden kann. Dies gilt für den Elementinhalt und ist kein Attribut des Elements. Der Standardwert ist false.
Wenn nillable true ist, kann eine Instanz dieses Elements das nil-Attribut auf true setzen. Das nil-Attribut ist als Teil des XML-Schema-Namespace für Instanzen definiert. |
| abstract | Optional. Gibt an, ob das Element in einem Instanzdokument verwendet werden kann. Wenn dieser Wert true ist, darf das Element nicht in einem Instanzdokument vorkommen. Stattdessen muss ein anderes Element, dessen substitutionGroup-Attribut den qualifizierten Namen (QName) dieses Elements enthält, an seiner Stelle erscheinen. Mehrere Elemente können in ihrem substitutionGroup-Attribut auf dieses Element verweisen. Der Standardwert ist false. |
| block | Optional. Abgeleitete Typen. Das block-Attribut verhindert, dass Elemente mit dem angegebenen Ableitungstyp verwendet werden, um dieses Element zu ersetzen. Der Wert kann #all oder eine Liste enthalten, die eine Teilmenge von extension, restriction oder substitution ist:
|
| final | Optional. Legt den Standardwert des final-Attributs für das element-Element fest. Dieses Attribut kann nicht verwendet werden, wenn das übergeordnete Element nicht das schema-Element ist. Der Wert kann #all oder eine Liste enthalten, die eine Teilmenge von extension oder restriction ist:
|
| beliebige Attribute | Optional. Gibt beliebige andere Attribute mit einem Nicht-Schema-Namespace an. |
Beispiel 1
Das folgende Beispiel ist ein Schema mit vier einfachen Elementen: "fname", "lname", "age" und "dateborn", mit den Typen string, nonNegativeInteger und date:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="fname" type="xs:string"/>
<xs:element name="lname" type="xs:string"/>
<xs:element name="age" type="xs:nonNegativeInteger"/>
<xs:element name="dateborn" type="xs:date"/>
</xs:schema>
Beispiel 2
Das folgende Beispiel ist ein Schema mit einem Element "note" vom komplexen Typ. Das Element "note" enthält vier einfache Elemente: "to", "from", "heading" und "body":
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Beispiel 3
Dieses Beispiel ist dasselbe wie Beispiel 2, aber in diesem Fall verwenden wir das ref-Attribut, um auf die Elementnamen zu verweisen:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element ref="to"/>
<xs:element ref="from"/>
<xs:element ref="heading"/>
<xs:element ref="body"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:schema>
Vollständiges XML-Schema-Referenzhandbuch Weitere Erweiterungen