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 zum Anwenden dieser Attribute auf eine XML-Webdienste-Methode finden Sie unter XML-Serialisierung mit XML-Webdiensten.
Weitere Informationen zu Attributen finden Sie unter Extending Metadata Using Attributes.
| Attribute | Betrifft | Bedeutung |
|---|---|---|
Ö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. |
|
Ö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. |
|
Ö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. |
|
Ö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. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Der Member wird als XML-Attribut serialisiert. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Der Member kann durch Verwendung einer Enumeration eindeutig bestimmt werden. |
|
Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert. |
Das Feld oder die Eigenschaft wird als XML-Element serialisiert. |
|
Öffentliches Feld, das ein Enumerationsbezeichner ist. |
Der Elementname eines Enumerationsmembers. |
|
Öffentliche Eigenschaften und Felder. |
Die Eigenschaft oder das Feld sollte beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert werden. |
|
Öffentlich abgeleitete Klassendeklarationen und Rückgabewerte von öffentlichen Methoden für WSDL-Dokumente (Web Services Description Language). |
Diese Klasse sollte beim Generieren von Schemas enthalten sein (und wird daher bei der Serialisierung erkannt). |
|
Deklarationen öffentlicher Klassen. |
Steuert die XML-Serialisierung des Attributziels als XML-Stammelement. Mit diesem Attribut können Sie Namespace und Elementnamen genauer angeben. |
|
Öffentliche Eigenschaften und Felder. |
Die Eigenschaft oder das Feld sollte als XML-Text serialisiert werden. |
|
Deklarationen öffentlicher Klassen. |
Der Name und Namespace des XML-Typs. |
Zusätzlich zu diesen Attributen, die sich alle im System.Xml.Serialization-Namespace befinden, können Sie auch das System.ComponentModel.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
Aufgaben
Vorgehensweise: Angeben eines alternativen Elementnamens für einen XML-Stream
Vorgehensweise: Serialisieren eines Objekts
Vorgehensweise: Deserialisieren eines Objekts
Verweis
Konzepte
Steuern der XML-Serialisierung mit Attributen