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>