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

Определяет заметку.

<annotation
  id = ID 
  {any attributes with non-schema Namespace}...>
Content: (appinfo | documentation)*
</annotation> 

Атрибуты

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

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

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

Количество вхождений

Один раз на родительский элемент.

Родительские элементы

Любой элемент

Описание

appinfo, documentation

Примечания

Аннотация может содержать элементы appinfo (информацию, которая будет использована приложениями) и элементы documentation (комментарии или текст для чтения или использования пользователями).

Пример

В следующем примере элементы annotation и documentation используются для документирования простого типа и перечислений, составляющих его определение.

<xs:simpleType name="northwestStates">
    <xs:annotation>
        <xs:documentation>States in the Pacific Northwest of US
</xs:documentation>
    </xs:annotation>
  <xs:restriction base="xs:string">
    <xs:enumeration value='WA'>
      <xs:annotation>
        <xs:documentation>Washington</xs:documentation>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value='OR'/>
      <xs:annotation>
        <xs:documentation>Oregon</xs:documentation>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value='ID'/>
      <xs:annotation>
        <xs:documentation>Idaho</xs:documentation>
      </xs:annotation>
    </xs:enumeration>
  </xs:restriction>
</xs:simpleType>

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

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

См. также

Ссылки

Справочник по XML-схемам (XSD)

Элементы XML-схемы