Bindungsunterstützung für das sequence-Element

.NET Framework stellt Bindungsunterstützung für das <sequence>-Element bereit.

Erklärung

Beim Generieren von Klassen aus Schemas generiert XML Schema Definition Tool (Xsd.exe) Member der Klasse (Felder oder Eigenschaften) in genau der Reihenfolge, in der sie im <sequence>-Element (oder im <all>-Element) aufgelistet sind. Wenn aber ein Schema aus einer bestimmten Klasseninstanz generiert wird, hängt die Reihenfolge der Member von der Reihenfolge ab, in der das Reflexionsmodul sie an den Serialisierer zurückgibt. Die Reihenfolge wird nicht definiert und ist variabel. Um die geordnete Folge im generierten Schema zu gewährleisten, legen Sie die Order-Eigenschaft der folgenden Attributklassen entsprechend fest: XmlElementAttribute, XmlAnyElementAttribute und XmlArrayAttribute. Wenn Sie mit dem Tool xsd.exe Klassen aus Schemas generieren, können Sie den /order-Befehlszeilenschalter verwenden, um die Order-Eigenschaft automatisch zu generieren.

Das <sequence>-Element stellt eine geordnete Gruppierung von Elementen bereit, die mittels <element>-XSD-Element oder bestimmter anderer XSD-Elemente definiert sind. Hingegen stellt das Bindungsunterstützung für das all-Element-Element eine ungeordnete Gruppierung einer Teilmenge der Elemente bereit, die im <sequence>-Element enthalten sein können.

Beim Generieren von Quellcode aus einem XML-Schemadokument erzeugt das Xsd.exe-Dienstprogramm öffentliche Felder in der gleichen Reihenfolge, in der der Inhalt des <sequence>-Elements oder des <all>-Elements vorliegt.

Beim Generieren eines XML-Schemadokuments aus einem Satz an Klassen in einer Assembly übersetzt Xsd.exe die öffentlichen Felder einer Klasse in die entsprechenden Elemente, die unter einem <sequence>-Element in der gleichen Reihenfolge erscheinen, in der die Felder in der Klasse erscheinen.

Dabei wird davon ausgegangen, dass Elemente eines komplexen Typs vorzugsweise geordnet und nicht ungeordnet angezeigt werden sollen.

Mögliche Attribute	Bindungsunterstützung
id	Das Dienstprogramm Xsd.exe ignoriert das id-Attribut, mit dem ein eindeutiger Bezeichner bereitgestellt werden soll.
maxOccurs	Beim <sequence>-Element wird ein maxOccurs-Wert von 0 von Xsd.exe als 1 interpretiert. Ein maxOccurs-Wert größer 1 wird als unbounded interpretiert. Bei der Verwendung von Xsd.exe mit Schemas, die mehrfach auftretende Sequenzen enthalten (Sequenzen mit maxOccurs größer als 1), verwenden Sie die /order-Befehlszeilenoption. Eine Begründung hierfür finden Sie in den Ausführungen zum Bindungsunterstützung für das maxOccurs-Attribut-Attribut.
minOccurs	Beim Generieren von Quellcode aus einem XML-Schemadokument ignoriert Xsd.exe das minOccurs-Attribut, wenn dieses auf ein <sequence>-Element angewendet wird. Beim Generieren eines XML-Schemadokuments aus Klassen gibt Xsd.exe keinen minOccurs-Wert an und stellt den Standardwert 1 wieder her. Weitere Informationen finden Sie in den Ausführungen zum Bindungsunterstützung für das minOccurs-Attribut-Attribut.

Mögliche übergeordnete Elemente: <choice>, <complexType>, <extension>, <group>, <restriction>

Mögliche untergeordnete Elemente: <annotation>, <any>, <choice>, <element>, <group>

Siehe auch

Referenz

XmlSchemaSequence

Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.