Attribute zur Steuerung der XML-Serialisierung

  • Artikel

Sie können die in der folgenden Tabelle aufgeführten Attribute auf Klassen und Klassenmember anwenden, um zu steuern, wie Instanzen der Klasse durch die XmlSerializer-Klasse serialisiert bzw. deserialisiert werden. Wie die XML-Serialisierung mithilfe dieser Attribute gesteuert wird, wird unter Steuern der XML-Serialisierung mit Attributen beschrieben.

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

Weitere Informationen zu Attributen finden Sie unter Attribute.

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 gefü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 gefü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 in der Regel in Verbindung 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 Verwendung 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 Elementname eines Enumerationsmembers.
XmlIgnoreAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld wird beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert.
XmlIncludeAttribute Öffentliche abgeleiteten Klassendeklarationen, und Rückgabewerte von öffentlichen Methoden für WSDL-Dokumente (Web Services Description Language). Diese 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.
ObsoleteAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld wird beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert.

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

Informationen zur Steuerung der XML-Serialisierung von codiertem SOAP finden Sie unter Attribute zur Steuerung der Serialisierung von codiertem SOAP.

Siehe auch