XML Schema elementЭлемент
Полное справочное руководство по XML Schema
Определение и использование
Элемент element определяет элемент.
Информация об элементе
- Родительский элемент: schema, choice, all, sequence, group
Синтаксис
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))
любые атрибуты
>
annotation?,(simpleType|complexType)?,(unique|key|keyref)*
</element>
(Символ ? означает, что элемент может появляться ноль или один раз внутри элемента element; символ * означает, что элемент может появляться ноль или более раз.)
| Атрибуты | Описание |
|---|---|
| id | Необязательно. Задает уникальный ID для элемента. |
| name | Необязательный. Задает имя элемента. Если родительским элементом является элемент schema, этот атрибут обязателен. |
| ref | Необязательный. Ссылка на другой элемент. Атрибут ref может содержать префикс пространства имен. Этот атрибут не используется, если родительским элементом является элемент schema. |
| type | Необязательный. Задает имя встроенного типа данных или имя элемента simpleType или complexType. |
| substitutionGroup | Необязательный. Задает имя элемента, который можно использовать для замены этого элемента. Этот элемент должен иметь тот же тип или тип, производный от указанного типа элемента. Этот атрибут нельзя использовать, если родительским элементом не является элемент schema. |
| default | Необязательный. Задает значение по умолчанию для элемента (используется только когда содержимое элемента имеет простой тип или textOnly). |
| fixed | Необязательный. Задает фиксированное значение для элемента (используется только когда содержимое элемента имеет простой тип или textOnly). |
| форма | Необязательный. Форма элемента. Значение по умолчанию — значение атрибута elementFormDefault элемента schema, содержащего этот атрибут. Значение должно быть одной из следующих строк: "qualified" или "unqualified". Если родительский элемент — это элемент schema, этот атрибут нельзя использовать.
|
| maxOccurs | Необязательный. Задаёт максимальное количество раз, которое элемент element может появиться в родительском элементе. Значение может быть целым числом, большим или равным нулю. Чтобы не устанавливать ограничение на максимальное число, используйте строку "unbounded". Значение по умолчанию — 1. Если родительский элемент — это элемент schema, этот атрибут нельзя использовать. |
| minOccurs | Необязательный. Задаёт минимальное количество раз, которое элемент element может появиться в родительском элементе. Значение может быть целым числом, большим или равным нулю. Значение по умолчанию — 1. Если родительский элемент — это элемент schema, этот атрибут нельзя использовать. |
| nillable | Необязательный. Указывает, можно ли элементу присвоить явное значение nil. Это относится к содержимому элемента и не является атрибутом элемента. Значение по умолчанию — false.
Если nillable имеет значение true, это позволит экземпляру этого элемента установить атрибут nil в true. Атрибут nil определён как часть пространства имён XML Schema для экземпляров. |
| abstract | Необязательный. Указывает, можно ли использовать элемент в документе экземпляра. Если это значение true, элемент не может появляться в документе экземпляра. Вместо него должен появиться другой элемент, атрибут substitutionGroup которого содержит квалифицированное имя (QName) этого элемента. Несколько элементов могут ссылаться на этот элемент в своём атрибуте substitutionGroup. Значение по умолчанию — false. |
| block | Необязательный. Производные типы. Атрибут block предотвращает использование элементов с указанным типом производности для подстановки вместо этого элемента. Значение может содержать #all или список, являющийся подмножеством extension, restriction или substitution:
|
| final | Необязательно. Задаёт значение по умолчанию атрибута final у элемента element. Этот атрибут нельзя использовать, если родительский элемент не является элементом schema. Значение может содержать #all или список, являющийся подмножеством extension или restriction:
|
| любые атрибуты | Необязательно. Задает любые другие атрибуты с пространством имен, не относящимся к схеме. |
Пример 1
В следующем примере представлена схема, содержащая четыре простых элемента: "fname", "lname", "age" и "dateborn", с типами string, nonNegativeInteger и 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>
Пример 2
В следующем примере представлена схема с элементом "note" сложного типа. Элемент "note" содержит четыре простых элемента: "to", "from", "heading" и "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>
Пример 3
Этот пример совпадает с примером 2, но в этом случае мы используем атрибут ref для ссылки на имена элементов:
<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 Другие расширения