XML Schema elementЭлемент


XML Schema 参考手册Полное справочное руководство по XML Schema

Определение и использование

Элемент element определяет элемент.

Информация об элементе

  • Родительский элемент: schema, choice, all, sequence, group

Синтаксис

<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))
любые атрибуты
>

annotation?,(simpleType|complexType)?,(unique|key|keyref)*

</element>

(Символ ? означает, что элемент может появляться ноль или один раз внутри элемента element; символ * означает, что элемент может появляться ноль или более раз.)

Необязательный. Указывает, можно ли элементу присвоить явное значение nil. Это относится к содержимому элемента и не является атрибутом элемента. Значение по умолчанию — false.

Если nillable имеет значение true, это позволит экземпляру этого элемента установить атрибут nil в true. Атрибут nil определён как часть пространства имён XML Schema для экземпляров.

Атрибуты Описание
id Необязательно. Задает уникальный ID для элемента.
name Необязательный. Задает имя элемента. Если родительским элементом является элемент schema, этот атрибут обязателен.
ref Необязательный. Ссылка на другой элемент. Атрибут ref может содержать префикс пространства имен. Этот атрибут не используется, если родительским элементом является элемент schema.
type Необязательный. Задает имя встроенного типа данных или имя элемента simpleType или complexType.
substitutionGroup Необязательный. Задает имя элемента, который можно использовать для замены этого элемента. Этот элемент должен иметь тот же тип или тип, производный от указанного типа элемента. Этот атрибут нельзя использовать, если родительским элементом не является элемент schema.
default Необязательный. Задает значение по умолчанию для элемента (используется только когда содержимое элемента имеет простой тип или textOnly).
fixed Необязательный. Задает фиксированное значение для элемента (используется только когда содержимое элемента имеет простой тип или textOnly).
форма

Необязательный. Форма элемента. Значение по умолчанию — значение атрибута elementFormDefault элемента schema, содержащего этот атрибут. Значение должно быть одной из следующих строк: "qualified" или "unqualified".

Если родительский элемент — это элемент schema, этот атрибут нельзя использовать.

  • Если значение — "unqualified", элемент не нужно квалифицировать префиксом пространства имён.
  • Если значение — "qualified", элемент должен быть квалифицирован префиксом пространства имён.
maxOccurs

Необязательный. Задаёт максимальное количество раз, которое элемент element может появиться в родительском элементе. Значение может быть целым числом, большим или равным нулю. Чтобы не устанавливать ограничение на максимальное число, используйте строку "unbounded". Значение по умолчанию — 1.

Если родительский элемент — это элемент schema, этот атрибут нельзя использовать.

minOccurs

Необязательный. Задаёт минимальное количество раз, которое элемент element может появиться в родительском элементе. Значение может быть целым числом, большим или равным нулю. Значение по умолчанию — 1.

Если родительский элемент — это элемент schema, этот атрибут нельзя использовать.

nillable
abstract

Необязательный. Указывает, можно ли использовать элемент в документе экземпляра. Если это значение true, элемент не может появляться в документе экземпляра. Вместо него должен появиться другой элемент, атрибут substitutionGroup которого содержит квалифицированное имя (QName) этого элемента. Несколько элементов могут ссылаться на этот элемент в своём атрибуте substitutionGroup. Значение по умолчанию — false.

block

Необязательный. Производные типы. Атрибут block предотвращает использование элементов с указанным типом производности для подстановки вместо этого элемента. Значение может содержать #all или список, являющийся подмножеством extension, restriction или substitution:

  • extension — предотвращает использование элементов, производных путём расширения, для подстановки вместо этого элемента.
  • restriction — предотвращает использование элементов, производных путём ограничения, для подстановки вместо этого элемента.
  • substitution — предотвращает использование элементов, производных путём подстановки, для подстановки вместо этого элемента.
  • #all — предотвращает использование всех производных элементов для подстановки вместо этого элемента.
final

Необязательно. Задаёт значение по умолчанию атрибута final у элемента element. Этот атрибут нельзя использовать, если родительский элемент не является элементом schema. Значение может содержать #all или список, являющийся подмножеством extension или restriction:

  • extension — предотвращает использование элементов, производных путём расширения, для подстановки вместо этого элемента
  • restriction — предотвращает использование элементов, производных путём ограничения, для подстановки вместо этого элемента
  • #all — предотвращает использование всех производных элементов для подстановки вместо этого элемента
любые атрибуты

Необязательно. Задает любые другие атрибуты с пространством имен, не относящимся к схеме.

Пример 1

В следующем примере представлена схема, содержащая четыре простых элемента: "fname", "lname", "age" и "dateborn", с типами string, nonNegativeInteger и 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>

Пример 2

В следующем примере представлена схема с элементом "note" сложного типа. Элемент "note" содержит четыре простых элемента: "to", "from", "heading" и "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>

Пример 3

Этот пример совпадает с примером 2, но в этом случае мы используем атрибут ref для ссылки на имена элементов:

<?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 参考手册Полное справочное руководство по XML Schema Другие расширения