Freigeben über

Attribute, die die XML-Serialisierung steuern

Sie können die Attribute in der folgenden Tabelle auf Klassen und Klassenmitglieder anwenden, um die Vorgehensweise zu steuern, in der die XmlSerializer eine Instanz der Klasse serialisiert oder deserialisiert. Informationen dazu, wie diese Attribute die XML-Serialisierung steuern, finden Sie unter Steuern der XML-Serialisierung mithilfe von Attributen.

Diese Attribute können auch verwendet werden, um die von einem XML-Webdienst generierten SOAP-Nachrichten im Literalstil 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 "Attribute".

Merkmal Gilt für: Bedeutung
XmlAnyAttributeAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, das ein Array von XmlAttribute Objekten zurückgibt. Beim Deserialisieren wird das Array mit XmlAttribute Objekten gefüllt, die alle XML-Attribute darstellen, die dem Schema unbekannt sind.
XmlAnyElementAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, das ein Array von XmlElement Objekten zurückgibt. Beim Deserialisieren wird das Array mit XmlElement Objekten gefüllt, die alle XML-Elemente darstellen, die für das Schema unbekannt sind.
XmlArrayAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, das ein Array komplexer Objekte zurückgibt. Die Elemente des Arrays werden als Elemente eines XML-Arrays generiert.
XmlArrayItemAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, das ein Array komplexer Objekte zurückgibt. 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. Das Element 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 Enumerationsmitglieds.
XmlIgnoreAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld sollte ignoriert werden, wenn die enthaltende Klasse serialisiert wird.
XmlIncludeAttribute Öffentliche abgeleitete Klassendeklarationen und Rückgabewerte öffentlicher Methoden für WSDL-Dokumente (Web Services Description Language). Die Klasse sollte beim Generieren von Schemas eingeschlossen werden (die beim Serialisieren erkannt werden sollen).
XmlRootAttribute Deklarationen öffentlicher Klassen. Steuert die XML-Serialisierung des Zielattributs als XML-Wurzelelement. Verwenden Sie das Attribut, um den Namespace und den Elementnamen weiter anzugeben.
XmlTextAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld sollte als XML-Text serialisiert werden.
XmlTypeAttribute Deklarationen öffentlicher Klassen. Der Name und der Namespace des XML-Typs.
ObsoleteAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld wird ignoriert, wenn die enthaltende Klasse serialisiert wird.

Zusätzlich zu diesen Attributen, die alle im System.Xml.Serialization Namespace gefunden werden, können Sie das DefaultValueAttribute Attribut auch auf ein Feld anwenden. Das DefaultValueAttribute legt den Wert fest, der dem Element automatisch zugewiesen wird, wenn kein Wert angegeben wird.

Informationen zum Steuern der codierten SOAP-XML-Serialisierung finden Sie unter Attribute that Control Encoded SOAP Serialization.

Siehe auch