Elemento <xsd:element>
Dichiara un elemento.
<element
abstract = Boolean : false
block = (#all | List of (extension | restriction | substitution))
default = string
final = (#all | List of (extension | restriction))
fixed = string
form = (qualified | unqualified)
id = ID
maxOccurs = (nonNegativeInteger | unbounded) : 1
minOccurs = nonNegativeInteger : 1
name = NCName
nillable = Boolean : false
ref = QName
substitutionGroup = QName
type = QName
{any attributes with non-schema Namespace}...>
Content: (annotation?, ((simpleType | complexType)?, (unique | key |
keyref)*))
</element>
Attributi
abstract
Indica se l'elemento può essere usato in un documento di istanza. Se questo valore è impostato su true, il documento di istanza non può contenere l'elemento, ma deve contenere un altro elemento il cui attributo substitutionGroup contiene il nome completo (QName) di questo elemento. Più elementi nell'attributo substitutionGroup possono fare riferimento a questo elemento.Il valore predefinito è false.
Facoltativo.
block
Il tipo di derivazione. L'attributo block impedisce a un elemento che dispone del tipo di derivazione specificato di essere utilizzato al posto di questo elemento. Questo valore può contenere #all o un elenco che è un sottoinsieme di extension, restriction o substitution.extension
Impedisce l'utilizzo di elementi derivati per estensione al posto di questo elemento.
restriction
Impedisce l'utilizzo di elementi derivati per restrizione al posto di questo elemento.
substitution
Impedisce l'utilizzo di elementi derivati per sostituzione al posto di questo elemento.
#all
Impedisce l'utilizzo di tutti gli elementi derivati al posto di questo elemento.
Facoltativo.
default
Il valore predefinito dell'elemento se il contenuto è un tipo semplice oppure textOnly.Gli attributi fixed e default si escludono a vicenda.
Se l'elemento contiene un tipo semplice, questo valore deve essere un valore valido per quel determinato tipo.
Facoltativo.
substitutionGroup
Il nome di un elemento che può sostituire questo elemento. Tale elemento deve presentare lo stesso tipo o un tipo derivato da quello dell'elemento specificato.Questo attributo può essere utilizzato se l'elemento di riferimento è dichiarato a livello globale (con elemento padre corrispondente all'elemento schema).
Questo valore deve essere un nome completo (QName).
Facoltativo.
final
Il tipo di derivazione. Con l'attributo final viene impostato il valore predefinito dell'attributo final nell'elemento element. Questo valore può contenere #all o un elenco che sia un sottoinsieme di extension o restriction.extension
Impedisce l'utilizzo di elementi derivati per estensione al posto di questo elemento.
restriction
Impedisce l'utilizzo di elementi derivati per restrizione al posto di questo elemento.
#all
Impedisce l'utilizzo di tutti gli elementi derivati al posto di questo elemento.
Non è consentito se l'elemento contenitore non è l'elemento schema.
Facoltativo.
fixed
Il valore predefinito e non modificabile dell'elemento se il contenuto è un tipo semplice oppure textOnly.Gli attributi fixed e default si escludono a vicenda.
Facoltativo.
form
La proprietà Form per l'elemento. Il valore predefinito corrisponde al valore dell'attributo elementFormDefault dell'elemento schema contenente l'attributo stesso. Il valore deve essere uno delle seguenti stringhe: "qualificato" o "non qualificato".Se il valore è non qualificato, non è necessario qualificare l'elemento con il prefisso dello spazio dei nomi.
Se il valore è qualificato, è necessario qualificare l'elemento con il prefisso dello spazio dei nomi.
Facoltativo.
id
L'identificatore di questo elemento. Il valore id deve essere del tipo identificatore e deve essere univoco all'interno del documento che contiene questo elemento.Facoltativo.
maxOccurs
Il numero massimo di occorrenze dell'elemento all'interno dell'elemento contenitore. Il valore può essere un numero intero maggiore o uguale a zero. Per eliminare qualsiasi limite al numero massimo, utilizzare la stringa "unbounded".Non è consentito se l'elemento contenitore è l'elemento schema.
Facoltativo.
minOccurs
Il numero minimo di volte in cui l'elemento può ricorrere nell'elemento contenitore. Il valore può essere un numero intero maggiore o uguale a zero. Per specificare che questo elemento è facoltativo, impostare l'attributo su zero.Non è consentito se l'elemento contenitore è l'elemento schema.
Facoltativo.
name
Il nome dell'elemento. Il nome deve essere senza due punti (NCName) in base alla specifica dello spazio dei nomi XML. Gli attributi name e ref non possono essere presenti contemporaneamente.È obbligatorio se l'elemento contenitore è l'elemento schema.
Facoltativo.
nillable
Questo attributo indica se è possibile assegnare all'elemento un valore Null esplicito. Si applica al contenuto dell'elemento e non agli attributi dell'elemento. Il valore predefinito è false.Se nillable è impostato su true, nelle istanze dell'elemento l'attributo nil non può essere impostato su true. L'attributo nil è definito come parte dello spazio dei nomi dello schema XML per le istanze.
Ad esempio, il seguente frammento definisce un solo elemento con nillable impostato su true.
<xs:element name="myDate" type="xs:date" nillable="true"/>Il seguente frammento utilizza quel determinato elemento e presenta un valore Null esplicito (attributo nil impostato su true).
<myDate xsi:nil="true"></myDate>Facoltativo.
ref
Il nome di un elemento dichiarato in questo schema (oppure in uno schema diverso indicato dallo spazio dei nomi specificato). Il valore ref deve essere un nome completo (QName). Il valore ref può includere un prefisso dello spazio dei nomi.Non è consentito se l'elemento contenitore è l'elemento schema.
Se è presente l'attributo ref, non possono essere presenti gli elementi complexType, simpleType, key, keyref e unique, nonché gli attributi nillable, default, fixed, form, block e type.
<xs:element ref="comment"/>Facoltativo.
type
Il nome di un tipo di dati incorporato oppure di un elemento simpleType o complexType definito in questo schema (o in uno schema diverso indicato dallo spazio dei nomi specificato). Il valore fornito deve corrispondere all'attributo name nell'elemento simpleType o complexType al quale fa riferimento.Gli attributi type e ref si escludono a vicenda.
Per dichiarare un elemento con la definizione di un tipo semplice o di un tipo complesso esistente, utilizzare l'attributo type per specificare il tipo esistente.
<xs:element name="name" type="xs:string"/>Facoltativo.
Informazioni sull'elemento
Numero di occorrenze |
Numero di elementi definito nello schema. |
Elementi padre |
|
Contenuto |
Osservazioni
Una dichiarazione di elemento associa un nome alla definizione del tipo, che può essere un tipo di dati incorporato, semplice o complesso.
Le dichiarazioni di elemento possono essere presenti come elementi figlio dell'elemento schema (con ambito globale) oppure possono essere presenti all'interno di definizioni del tipo complesso. Nei tipi complessi le dichiarazioni di elemento possono essere presenti come dichiarazioni locali oppure come riferimenti a elementi con ambito globale.
Le definizioni di elemento globale devono definire direttamente tipi complessi.
Un elemento simpleType o complexType può essere presente come figlio solo se non sono presenti gli attributi ref e type.
Inoltre, gli elementi possono essere presenti per riferimento all'interno degli elementi choice, all, sequence e complexType.
Esempi
Nel seguente esempio sono contenuti due elementi che possono essere utilizzati come sostituiti per un altro elemento.
Altre risorse
Per ulteriori informazioni, vedere la raccomandazione W3C XML Schema Part 1: Structures all'indirizzo www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all (informazioni in lingua inglese).
Vedere anche
Riferimento
Riferimenti dello schema XML (XSD)
Elementi dello schema XML