XML Schema attribute-element
Definition og brug
attribute-elementet definerer en egenskab.
Elementinformation
Antal forekomster | Defineres én gang i schema-elementet. Citeres flere gange i komplekse typer eller attributgrupper. |
Forældrelement | attributeGroup、schema、complexType、restriction (simpleContent)、extension (simpleContent)、restriction (complexContent)、extension (complexContent) |
Indhold | annotation、simpleType |
Syntaks
<attribute default=string fixed=string form=qualified|unqualified id=ID name=NCName ref=QName type=QName use=optional|prohibited|required any attributes > (annotation?,(simpleType?)) </attribute>
(?-symbolet angiver, at elementet kan forekomme nul eller én gang i attribute-elementet。)
Attribut
default
Valgfri. Angiver standardværdien for attributten. Default- og fixed-attributter kan ikke bruges samtidig.
fixed
Valgfri. Angiver den faste værdi for attributten. Default- og fixed-attributter kan ikke bruges samtidig.
form
Valgfri. Angiver formatet for attributten. Standardværdien er værdien af attributeFormDefault-attributten i schema-elementet, der indeholder attributten. Kan sættes til følgende værdier:
- "qualified" - Angiver, at attributet skal specificeres med navnespacesuffikset og attributternes ikke-kolonnes navn (NCName).
- "unqualified" - Indikerer, at denne egenskab ikke kræver en navnerum præfiks og ikke skal matche dette egenskabs ikke-kolonnavn (NCName), dvs. lokal navn.
id
Valgfri. Specificer det unikke ID for elementet.
navn
Valgfri. Specificer egenskabens navn. name- og ref-attributter kan ikke bruges samtidig.
ref
Valgfri. Specificer en reference til den specifikke egenskab. name- og ref-attributter kan ikke bruges samtidig. Hvis ref forekommer, kan simpleType-element, form og type ikke forekomme.
type
Valgfri. Specificer indbygget data-type eller simpel type. type-attribut kan kun forekomme, når indholdet ikke indeholder en simpleType-element.
brug
Valgfri. Specificer hvordan egenskaben skal bruges. Kan sættes til følgende værdier:
- valgfri - Egenskaben er valgfri og kan have enhver værdi (standard).
- prohibiteret - Kan ikke bruge egenskab.
- krævet - Egenskabens nødvendige.
any attributes
Valgfri. Specificer eventuelle andre egenskaber med non-schema navnerum.
Eksempel
Eksempel 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>
Denne eksempel indikerer, at "code"-egenskaben har en begrænsning. De eneste acceptable værdier er to bogstaver fra store bogstaver A til Z.
Eksempel 2
For at bruge en eksisterende egenskabsdefinition i en kompleks type til at erklære en egenskab, brug ref-attributten:
<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>
Eksempel 3
Egenskaben kan have både en standardværdi og en specificeret fast værdi. Hvis ingen andre værdier er specificeret, tildeles værdien automatisk til egenskaben. I det følgende eksempel er standardværdien "EN":
<xs:attribute name="lang" type="xs:string" default="EN"/>
Hvis ingen andre værdier er specificeret, tildeles værdien automatisk til egenskaben. Men forskellig fra standardværdi, hvis du har specificeret en værdi, der ikke er en fast værdi for egenskaben, vil dokumentet verificere det som ugyldigt. I det følgende eksempel er den faste værdi "EN":
<xs:attribute name="lang" type="xs:string" fixed="EN"/>
Eksempel 4
Alle egenskaber er som standard valgfri. For at specificere et egenskab som valgfrit tydeligt, skal du bruge "use" egenskaben:
<xs:attribute name="lang" type="xs:string" use="optional"/>
Gør egenskaben obligatorisk:
<xs:attribute name="lang" type="xs:string" use="required"/>