Supporto dell'associazione all'elemento sequence
Questo argomento è specifico di una tecnologia legacy. Servizi Web XML e client di servizi Web XML devono essere creati attualmente tramite Windows Communication Foundation.
In .NET Framework è incluso un supporto per l'associazione all'elemento <sequence> .
Descrizione
Durante la generazione di classi dallo schema, lo strumento XML Schema Definition Tool (Xsd.exe) genera i membri della classe (campi o proprietà) nell'ordine esatto in cui vengono elencati nell'elemento <sequence><all> (o ). Se invece si genera uno schema da un'istanza di una classe specifica, l'ordine dei membri dipenderà dall'ordine in cui vengono restituiti al serializzatore dal motore di reflection. L'ordine non è definito ed è variabile. Per definire la sequenza di ordinamento nello schema generato, impostare la proprietà Order delle seguenti classi di attributi in base alle proprie esigenze: XmlElementAttribute, XmlAnyElementAttribute e XmlArrayAttribute. Durante la generazione di classi dallo schema tramite lo strumento xsd.exe, è possibile utilizzare l'opzione della riga di comando /order per generare automaticamente la proprietà Order.
L'elemento <sequence> garantisce un raggruppamento ordinato di elementi definiti mediante l'elemento XSD <element> o altri elementi XSD specifici. L'elemento Supporto dell'associazione all'elemento all**<, invece, offre un raggruppamento non ordinato di un sottoinsieme degli elementi che possono essere contenuti nell'elemento >**sequence.
Durante la generazione di codice sorgente da un documento XML Schema, l'utilità Xsd.exe produce campi pubblici nello stesso ordine del contenuto dell'elemento <sequence> o dell'elemento <all>.
Durante la generazione di un documento XML Schema da un set di classi di un assembly, Xsd.exe converte i campi pubblici di una classe negli elementi appropriati che vengono visualizzati sotto un elemento <sequence> nello stesso ordine con cui i campi vengono visualizzati nella classe.
Il presupposto è che gli elementi compresi in un tipo complesso devono essere elencati in maniera ordinata.
| Attributi possibili | Supporto per l'associazione |
|---|---|
id |
L'utilità Xsd.exe ignora l'attributo id che fornisce un identificatore univoco. |
maxOccurs |
Per l'elemento <sequence> un valore maxOccurs pari a Quando si utilizza Xsd.exe con schemi che presentano sequenze con ricorrenze multiple (sequenze in cui maxOccurs è maggiore di 1), utilizzare l'opzione della riga di comando /order. Per ulteriori informazioni sul motivo per cui questa operazione è necessaria, vedere l'attributo Supporto dell'associazione all'attributo MaxOccurs. |
minOccurs |
Durante la generazione di codice sorgente da un documento XML Schema, Xsd.exe ignora l'attributo minOccurs in caso di applicazione dell'elemento <sequence>. Durante la generazione di un documento XML Schema dalle classi, Xsd.exe non specifica un valore minOccurs determinando in questo modo il ripristino del valore predefinito Vedere l'attributo Supporto dell'associazione all'attributo MinOccurs. |
Elementi padre possibili: <choice>, <complexType>, <extension>, <group>, <restriction>
Elementi figlio possibili: <annotation>, <any>, <choice>, <element>, <group>