XML Schema attributeElement


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

Definition und Verwendung

Das attribute-Element definiert ein Attribut.

Elementinformationen

  • Elternelement(e): attributeGroup, schema, complexType, restriction (sowohl simpleContent als auch complexContent), extension (sowohl simpleContent als auch complexContent)

Syntax

<attribute
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
beliebige Attribute
>

(annotation?,(simpleType?))

</attribute>

(Das ?-Zeichen deklariert, dass das Element null- oder einmal innerhalb des attribute-Elements vorkommen kann.)

Attribute Beschreibung
default Optional. Gibt den Standardwert des Attributs an. Die Attribute default und fixed können nicht beide vorkommen.
fixed Optional. Gibt den festen Wert des Attributs an. Die Attribute default und fixed können nicht beide vorkommen.
Form

Optional. Gibt das Format des Attributs an. Der Standardwert ist der Wert des Attributs attributeFormDefault des schema-Elements, das das Attribut enthält. Kann auf die folgenden Werte gesetzt werden:

  • "qualified" - Gibt an, dass dieses Attribut durch ein Namespace-Präfix und den doppelpunktlosen Namen (NCName) des Attributs qualifiziert werden muss.
  • "unqualified" - Gibt an, dass dieses Attribut nicht durch ein Namespace-Präfix qualifiziert werden muss und nicht mit dem doppelpunktlosen Namen (NCName) des Attributs übereinstimmen muss, d. h. dem lokalen Namen.
id Optional. Gibt eine eindeutige ID für das Element an.
name Optional. Gibt den Namen des Attributs an. Die Attribute name und ref können nicht beide vorkommen.
ref Optional. Gibt eine Referenz auf das angegebene Attribut an. Die Attribute name und ref können nicht beide vorkommen. Wenn ref vorkommt, können das simpleType-Element, form und type nicht vorkommen.
type Optional. Gibt einen integrierten Datentyp oder einen einfachen Typ an. Das Attribut type darf nur auftreten, wenn der Inhalt kein simpleType-Element enthält.
Verwenden Sie

Optional. Gibt an, wie das Attribut verwendet wird. Kann auf die folgenden Werte gesetzt werden:

  • optional - Das Attribut ist optional und kann einen beliebigen Wert haben (Standard).
  • prohibited - Das Attribut kann nicht verwendet werden.
  • required - Das Attribut ist erforderlich.
beliebige Attribute Optional. Gibt jedes andere Attribut mit einem Nicht-Schema-Namespace an.

Beispiel 1

<xs:attribute name="code">

<xs:simpleType>
  <xs:restriction base="xs:string">
    <xs:pattern value="[A-Z][A-Z]"/>
  </xs:restriction>
</xs:simpleType>

</xs:attribute>

Das obige Beispiel zeigt, dass das Attribut "code" eine Einschränkung hat. Die einzig akzeptablen Werte sind zwei Großbuchstaben von A bis Z.

Beispiel 2

Um ein Attribut unter Verwendung einer vorhandenen Attributdefinition in einem komplexen Typ zu deklarieren, verwenden Sie das Attribut ref:

<xs:attribute name="code">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[A-Z][A-Z]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:attribute>

<xs:complexType name="someComplexType">
  <xs:attribute ref="code"/>
</xs:complexType>

Beispiel 3

Ein Attribut kann entweder einen Standardwert oder einen angegebenen festen Wert haben. Wenn kein anderer Wert angegeben wird, wird dem Attribut automatisch der Standardwert zugewiesen. Im folgenden Beispiel ist der Standardwert "EN":

<xs:attribute name="lang" type="xs:string" default="EN"/>

Wenn kein anderer Wert angegeben wird, wird dem Attribut automatisch der feste Wert zugewiesen. Im Gegensatz zum Standardwert wird das Dokument jedoch als ungültig validiert, wenn Sie für das Attribut einen anderen Wert als den festen Wert angeben. Im folgenden Beispiel ist der feste Wert "EN":

<xs:attribute name="lang" type="xs:string" fixed="EN"/>

Beispiel 4

Alle Attribute sind standardmäßig optional. Um ein Attribut explizit als optional anzugeben, verwenden Sie das Attribut "use":

<xs:attribute name="lang" type="xs:string" use="optional"/>

Ein Attribut als erforderlich festlegen:

<xs:attribute name="lang" type="xs:string" use="required"/>


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