XML Schema elementElement


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

Definition und Verwendung

Das Element element definiert ein Element.

Elementinformationen

  • Übergeordnetes Element: schema, choice, all, sequence, group

Syntax

<element
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.)

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.

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.

  • Wenn der Wert "unqualified" ist, muss das Element nicht mit einem Namespace-Präfix qualifiziert werden.
  • Wenn der Wert "qualified" ist, muss das Element mit einem Namespace-Präfix qualifiziert 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
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:

  • extension - verhindert, dass durch Erweiterung abgeleitete Elemente verwendet werden, um dieses Element zu ersetzen.
  • restriction - verhindert, dass durch Einschränkung abgeleitete Elemente verwendet werden, um dieses Element zu ersetzen.
  • substitution - verhindert, dass durch Substitution abgeleitete Elemente verwendet werden, um dieses Element zu ersetzen.
  • #all - verhindert, dass alle abgeleiteten Elemente verwendet werden, um dieses Element zu ersetzen.
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:

  • extension - verhindert, dass durch Erweiterung abgeleitete Elemente verwendet werden, um dieses Element zu ersetzen
  • restriction - verhindert, dass durch Einschränkung abgeleitete Elemente verwendet werden, um dieses Element zu ersetzen
  • #all - verhindert, dass alle abgeleiteten Elemente verwendet werden, um dieses Element zu ersetzen
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:

<?xml version="1.0"?>
<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":

<?xml version="1.0"?>
<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:

<?xml version="1.0"?>
<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>


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