Attribute für die Steuerung der XML-Serialisierung

Sie können die Attribute in der folgenden Tabelle auf Klassen und Klassenmember anwenden, um zu steuern, auf welche Art eine Instanz der Klasse durch die XmlSerializer-Klasse serialisiert oder deserialisiert wird. Eine Beschreibung der Steuerung der XML-Serialisierung mit diesen Attributen finden Sie unter Steuern der XML-Serialisierung mit Attributen.

Diese Attribute können auch verwendet werden, um die durch einen XML-Webdienst generierten literalen SOAP-Meldungen zu steuern. Weitere Informationen zum Anwenden dieser Attribute auf eine XML-Webdienstmethode finden Sie unter XML-Serialisierung mit XML-Webdiensten.

Weitere Informationen zu Attributen finden Sie unter Erweitern von Metadaten mit Hilfe von Attributen.

Attribut	Betrifft	Bedeutung
XmlAnyAttributeAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlAttribute-Objekten zurückgegeben wird.	Beim Deserialisieren wird das Array mit XmlAttribute-Objekten aufgefüllt, die für alle im Schema unbekannten XML-Attribute stehen.
XmlAnyElementAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlElement-Objekten zurückgegeben wird.	Beim Deserialisieren wird das Array mit XmlElement-Objekten aufgefüllt, die für alle im Schema unbekannten XML-Elemente stehen.
XmlArrayAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird.	Die Member des Arrays werden als Member eines XML-Arrays generiert.
XmlArrayItemAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird.	Die abgeleiteten Typen, die in ein Array eingefügt werden können. Wird i. d. R. im Zusammenhang mit einem XmlArrayAttribute-Objekt angewendet.
XmlAttributeAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.	Der Member wird als XML-Attribut serialisiert.
XmlChoiceIdentifierAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.	Der Member kann durch Verwenden einer Enumeration eindeutig bestimmt werden.
XmlElementAttribute	Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.	Das Feld oder die Eigenschaft wird als XML-Element serialisiert.
XmlEnumAttribute	Öffentliches Feld, das ein Enumerationsbezeichner ist.	Der Membername eines Enumerationsmembers.
XmlIgnoreAttribute	Öffentliche Eigenschaften und Felder.	Die Eigenschaft oder das Feld wird beim Serialisieren der enthaltenden Klasse ignoriert.
XmlIncludeAttribute	Öffentliche abgeleitete Klassendeklarationen und Rückgabewerte öffentlicher Methoden (für WSDL-Dokumente, Web Service Description Language).	Die Klasse wird beim Generieren von Schemas eingeschlossen (und daher bei der Serialisierung erkannt).
XmlRootAttribute	Deklarationen öffentlicher Klassen.	Steuert die XML-Serialisierung des Attributziels als XML-Stammelement. Mit diesem Attribut können Sie Namespace und Elementnamen genauer angeben.
XmlTextAttribute	Öffentliche Eigenschaften und Felder.	Die Eigenschaft oder das Feld soll als XML-Text serialisiert werden.
XmlTypeAttribute	Deklarationen öffentlicher Klassen.	Der Name und Namespace des XML-Typs.

Zusätzlich zu diesen Attributen, die alle im System.Xml.Serialization-Namespace enthalten sind, können Sie auch das System.ComponentModel.DefaultValueAttribute-Attribut auf ein Feld anwenden. Durch DefaultValueAttribute wird der Wert festgelegt, der automatisch dem Member zugewiesen wird, wenn kein Wert angegeben wurde.

Informationen zum Steuern der XML-Serialisierung von codiertem SOAP finden Sie unter Attribute für die Steuerung der Serialisierung von codiertem SOAP.

Siehe auch

XML- und SOAP-Serialisierung | XmlSerializer | Steuerung der XML-Serialisierung mit Attributen | Überschreiben der XML-Serialisierung