Элемент <xsd:group>

Статья
05/06/2011

Группирует набор объявлений элементов таким образом, что их можно включить в качестве группы в определения сложных типов.

<group
  name= NCName
  id = ID
  maxOccurs = (nonNegativeInteger | unbounded) : 1
  minOccurs = nonNegativeInteger : 1
  name = NCName
  ref = QName
  {any attributes with non-schema Namespace}...>
Content: (annotation?, (all | choice | sequence))
</group>

Атрибуты

name
Имя группы. Имя не должно содержать двоеточий (NCName), как определено в спецификации пространств имен XML.

Этот атрибут используется только в случае, когда элемент schema является родителем данного элемента group element. В данном случае group является группой модели, которая будет использоваться элементами complexType, choice и sequence.

Необязательный.

id
Идентификатор данного элемента. Значение id должно иметь тип ID и быть уникальным в пределах документа, содержащего этот элемент.

Необязательный.

maxOccurs
Максимальное число появлений элемента в содержащем его элементе. Это значение должно быть целым числом, большим или равным 0. Для того, чтобы снять ограничение на максимальное число, используйте строку "unbounded".

Ограничено, если группа не является дочерней по отношению к элементу schema.

Необязательный.

minOccurs
Минимальное число появлений элемента в содержащем его элементе. Это значение должно быть целым числом, большим или равным 0. Чтобы указать, что элемент необязателен, установите атрибуту значение 0.

Ограничено, если группа не является дочерней по отношению к элементу schema.

Необязательный.

name
Имя элемента. Имя не должно содержать двоеточий (NCName), как определено в спецификации пространств имен XML. Атрибуты Name и ref не могут присутствовать одновременно.

Обязательный атрибут, если содержащим является элемент schema.

Необязательный.

ref
Имя группы, определенной в этой схеме (или другой схеме, заданной указанным пространством имен). Значение ref должно иметь тип QName. ref может включать префикс, определяющий пространство имен.

При наличии атрибута ref могут присутствовать также атрибуты id, minOccurs и maxOccurs. Атрибуты Ref and name являются взаимоисключающими.

Чтобы объявить группу с использованием существующего определения группы, используйте атрибут ref для указания существующего определения группы.
```
<xs:group ref="globalGroup"/>
```
Необязательный.

Сведения об элементе

Количество вхождений	Без ограничений
Родительские элементы	schema, choice, sequence, complexType, restriction (complexContent), extension (complexContent)
Содержимое	annotation, all, choice, sequence

Примечания

Любой из следующих элементов может быть дочерним для элемента group.

choice	Разрешает один и только один элемент из имеющихся в группе.
sequence	Требует, чтобы элементы группы появлялись в указанной последовательности.
all	Позволяет элементам группы появляться (или не появляться) в содержащем элементе в любом порядке.

Атрибуты minOccurs и maxOccurs имеют по умолчанию значение 1. Группа, у которой нет ни одного из этих атрибутов, должна появиться в объемлющем элементе один и только один раз.

Пример

Следующий пример определяет группу, содержащую последовательность из трех элементов, и использует элемент group в определении сложного типа.

Другие ресурсы

Дополнительные сведения см. в документе «Рекомендация W3C по схемам XML, часть 1: структуры» по адресу www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all.

См. также

Справочник

Справочник по схемам XML (XSD)
Элементы схемы XML

Поделиться через