Prise en charge de la liaison de l'élément Sequence

Le .NET Framework prend en charge la liaison pour l'élément <sequence>.

Explication

Lors de la génération de classes à partir d'un schéma, XML Schema Definition Tool (Xsd.exe) génère des membres de la classe (champs ou propriétés) dans l'ordre exact dans lequel ils sont répertoriés dans l'élément <sequence> (ou <all>). Néanmoins, lors de la génération d'un schéma à partir d'une instance de classe donnée, l'ordre des membres dépend de l'ordre dans lequel le moteur de réflexion les retourne au sérialiseur. L'ordre n'est pas défini et est variable. Pour garantir l'ordre de la séquence dans le schéma généré, définissez la propriété Order des classes d'attributs suivantes de la manière appropriée : XmlElementAttribute, XmlAnyElementAttribute et XmlArrayAttribute. Lors de la génération de classes à partir d'un schéma à l'aide de l'outil xsd.exe, vous pouvez utiliser le commutateur de ligne de commande /order pour générer automatiquement la propriété Order.

L'élément <sequence> fournit un regroupement ordonné d'éléments définis à l'aide de l'élément XSD**<element>** ou de certains autres éléments XSD. À l'inverse, l'élément Prise en charge de la liaison de l'élément All fournit un regroupement non ordonné d'un sous-ensemble des éléments que l'élément <sequence> peut contenir.

Lors de la génération du code source à partir d'un document de schéma XML, l'utilitaire Xsd.exe génère des champs publics dans le même ordre que le contenu de l'élément <sequence>, ou de l'élément <all> dans ce cas.

Lors de la génération d'un document de schéma XML à partir d'un ensemble de classes dans un assembly, Xsd.exe traduit les champs publics d'une classe en éléments appropriés qui apparaissent sous un élément <sequence> dans le même ordre d'apparition que les champs dans la classe.

Les éléments dans un type complexe doivent normalement apparaître dans l'ordre, et non dans le désordre.

Attributs possibles	Prise en charge de la liaison
id	L'utilitaire Xsd.exe ignore l'attribut id qui a pour but de fournir un identificateur unique.
maxOccurs	Pour l'élément <sequence>, une valeur maxOccurs de 0 est interprétée par Xsd.exe comme la valeur 1, et une valeur maxOccurs supérieure à 1 est interprétée comme la valeur unbounded. Lorsque vous utilisez Xsd.exe avec des schémas qui ont plusieurs séquences qui surviennent (séquences avec maxOccurs supérieur à 1), utilisez l'option de ligne de commande /order. Pour plus d'informations sur la raison de cela, consultez l'attribut Prise en charge de la liaison de l'attribut MaxOccurs.
minOccurs	Lors de la génération du code source à partir d'un document de schéma XML, Xsd.exe ignore l'attribut minOccurs s'il est appliqué à l'élément <sequence>. Lors de la génération d'un document de schéma XML à partir des classes, Xsd.exe ne spécifie pas de valeur minOccurs, et la valeur par défaut 1 est restaurée. Consultez l'attribut Prise en charge de la liaison de l'attribut MinOccurs.

Éléments parents possibles :  <choice>, <complexType>, <extension>, <group>, <restriction>

Éléments enfants possibles :  <annotation>, <any>, <choice>, <element>, <group>

Voir aussi

Référence

XmlSchemaSequence

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.