Attribute zur Steuerung der XML-Serialisierung
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.
