Freigeben über


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 Extending Metadata Using Attributes.

Attribut Anwendung 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-Elementen 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.

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 dem Member automatisch zugewiesen wird, falls kein Wert angegeben wurde.

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

Siehe auch

Aufgaben

Gewusst wie: Angeben eines alternativen Elementnamens für einen XML-Stream
Gewusst wie: Serialisieren eines Objekts
Gewusst wie: Deserialisieren eines Objekts

Referenz

XmlSerializer

Konzepte

Steuern der XML-Serialisierung mit Attributen

Weitere Ressourcen

XML- und SOAP-Serialisierung

Footer image

Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.