XML Schema element 元素
Definition and Usage
element nau'war ta define a element.
Element Information
Occurrence | Number of elements defined in the schema. |
Parent Element | schema,choice,all,sequence |
Content | simpleType,complexType,key,keyref,unique |
Syntax
<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>
(? amfani a cikin element nau'war, wannan nau'war ya iya da zama ko wata ko kashi).
attributes
id
auwai. Iya zai fannin ID na gurin dace na uku.
name
auwai. Iya zai fannin sunan gurin dace. idan abin da ya ba da asali dace schema, wannan nau'war yana dace.
ref
auwai. Iya zai fannin nasara gurin dace. ref nau'war ya iya da amfani da sunan waje. idan abin da ya ba da asali dace schema, ya da da kama amfani da wannan nau'war.
type
auwai. Iya zai fannin sunan nau'war dace da ke tsakiya ko sunan gurin dace simpleType ko complexType.
substitutionGroup
auwai. Iya zai fannin sunan gurin dace don zama ayyukan wata gurin dace. wannan gurin dace ya dace da wata sama ko wata dace dake daga wannan nau'war.
idan abin da ya ba da asali dace schema, ya da da kama amfani da wannan nau'war.
default
auwai. Iya zai fannin gurin dace ta zaiwa (kainanin da aya yauwa cikin dace ko amfani).
fixed
auwai. Iya zai fannin gurin dace ta zaiwa (kainanin da aya yauwa cikin dace ko amfani).
form
可选。该元素的形式。 默认值是包含该属性的 schema 元素的 elementFormDefault 属性的值。 该值必须是下列字符串之一: “qualified” 或 “unqualified”。
如果父元素是 schema 元素,则不能使用该属性。
- 如果该值是 “unqualified”,则无须通过命名空间前缀限定该元素。
- 如果该值是 “qualified”,则必须通过命名空间前缀限定该元素。
maxOccurs
可选。规定 element 元素在父元素中可出现的最大次数。该值可以是大于或等于零的整数。若不想对最大次数设置任何限制,请使用字符串 "unbounded"。 默认值为 1。
如果父元素是 schema 元素,则不能使用该属性。
minOccurs
可选。规定 element 元素在父元素中可出现的最小次数。该值可以是大于或等于零的整数。默认值为 1。
如果父元素是 schema 元素,则不能使用该属性。
nillable
可选。指示是否可以将显式的零值分配给该元素。此项应用于元素内容并且不是该元素的属性。 默认值为 false。
如果 nillable 为 true,将使该元素的实例可以将 nil 属性设置为 true。 nil 属性被定义为实例的 XML 架构命名空间的一部分。
Wani lokaci, abin da zai zai bayan yau ya gina abin da yana nufin shi da nillable a gina shi.
<xs:element name="myDate" type="xs:date" nillable="true"/>
Abin da zai zai bayan yau ya amfani da abin da yana nufin shi da wuri na kashi (nil attrubutin ana gina shi).
<myDate xsi:nil="true"></myDate>
abstract
Iya. Na'uri. ya nufin ko abin da zai amfani da shi a doki na shirin. Idan wuri shine true, abin ya iya zai yin amfani da shi a doki na shirin. Kafin, attrubutin substitutionGroup ya kufata sunan abin da yana nufin (QName) na abin da yana nufin abin da ya wakilci shi a yankin. Abin da zai iya zai yin amfani da shi a attrubutin substitutionGroup shine abin da ya wakilci shi. Wurin na gudanarwa shine false.
block
Iya. Na'uri. Yankin da zai zai kai. Attrubutin block ya iya kuma zai amfani da abin da yana nufin na'uri a yankin yau a gina. Wurin zai iya dacewa daga #all ko yankin na extension, restriction ko substitution:
- extension - yancin ta hana ka fi wakilin abin da zai zai yin yankin yau a gina.
- 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>