Attribute zur Steuerung der XML-SerialisierungAttributes That Control XML Serialization

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.You can apply the attributes in the following table to classes and class members to control the way in which the XmlSerializer serializes or deserializes an instance of the class. Wie die XML-Serialisierung mithilfe dieser Attribute gesteuert wird, wird unter Steuern der XML-Serialisierung mit Attributen beschrieben.To understand how these attributes control XML serialization, see Controlling XML Serialization Using Attributes.

Diese Attribute können auch verwendet werden, um die durch einen XML-Webdienst generierten literalen SOAP-Nachrichten zu steuern.These attributes can also be used to control the literal style SOAP messages generated by an XML Web service. Weitere Informationen zur Anwendung dieser Attribute auf eine XML-Webdienstmethode finden Sie unter XML-Serialisierung mit XML-Webdiensten.For more information about applying these attributes to an XML Web services method, see XML Serialization with XML Web Services.

Weitere Informationen zu Attributen finden Sie unter Attribute.For more information about attributes, see Attributes.

AttributAttribute BetrifftApplies to BedeutungSpecifies
XmlAnyAttributeAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlAttribute-Objekten zurückgegeben wird.Public field, property, parameter, or return value that returns an array of XmlAttribute objects. Beim Deserialisieren wird das Array mit XmlAttribute-Objekten gefüllt, die für alle im Schema unbekannten XML-Attribute stehen.When deserializing, the array will be filled with XmlAttribute objects that represent all XML attributes unknown to the schema.
XmlAnyElementAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von XmlElement-Objekten zurückgegeben wird.Public field, property, parameter, or return value that returns an array of XmlElement objects. Beim Deserialisieren wird das Array mit XmlElement-Objekten gefüllt, die für alle im Schema unbekannten XML-Elemente stehen.When deserializing, the array is filled with XmlElement objects that represent all XML elements unknown to the schema.
XmlArrayAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird.Public field, property, parameter, or return value that returns an array of complex objects. Die Member des Arrays werden als Member eines XML-Arrays generiert.The members of the array will be generated as members of an XML array.
XmlArrayItemAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert, wodurch ein Array von komplexen Objekten zurückgegeben wird.Public field, property, parameter, or return value that returns an array of complex objects. Die abgeleiteten Typen, die in ein Array eingefügt werden können.The derived types that can be inserted into an array. Wird in der Regel in Verbindung mit einem XmlArrayAttribute-Objekt angewendet.Usually applied in conjunction with an XmlArrayAttribute.
XmlAttributeAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.Public field, property, parameter, or return value. Der Member wird als XML-Attribut serialisiert.The member will be serialized as an XML attribute.
XmlChoiceIdentifierAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.Public field, property, parameter, or return value. Der Member kann durch Verwendung einer Enumeration eindeutig bestimmt werden.The member can be further disambiguated by using an enumeration.
XmlElementAttribute Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.Public field, property, parameter, or return value. Das Feld oder die Eigenschaft wird als XML-Element serialisiert.The field or property will be serialized as an XML element.
XmlEnumAttribute Öffentliches Feld, das ein Enumerationsbezeichner ist.Public field that is an enumeration identifier. Der Elementname eines Enumerationsmembers.The element name of an enumeration member.
XmlIgnoreAttribute Öffentliche Eigenschaften und Felder.Public properties and fields. Die Eigenschaft oder das Feld wird beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert.The property or field should be ignored when the containing class is serialized.
XmlIncludeAttribute Öffentliche abgeleiteten Klassendeklarationen, und Rückgabewerte von öffentlichen Methoden für WSDL-Dokumente (Web Services Description Language).Public derived class declarations, and return values of public methods for Web Services Description Language (WSDL) documents. Diese Klasse wird beim Generieren von Schemas eingeschlossen (und daher bei der Serialisierung erkannt).The class should be included when generating schemas (to be recognized when serialized).
XmlRootAttribute Deklarationen öffentlicher Klassen.Public class declarations. Steuert die XML-Serialisierung des Attributziels als XML-Stammelement.Controls XML serialization of the attribute target as an XML root element. Mit diesem Attribut können Sie Namespace und Elementnamen genauer angeben.Use the attribute to further specify the namespace and element name.
XmlTextAttribute Öffentliche Eigenschaften und Felder.Public properties and fields. Die Eigenschaft oder das Feld soll als XML-Text serialisiert werden.The property or field should be serialized as XML text.
XmlTypeAttribute Deklarationen öffentlicher Klassen.Public class declarations. Der Name und Namespace des XML-Typs.The name and namespace of the XML type.

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.In addition to these attributes, which are all found in the System.Xml.Serialization namespace, you can also apply the DefaultValueAttribute attribute to a field. Durch DefaultValueAttribute wird der Wert festgelegt, der dem Member automatisch zugewiesen wird, falls kein Wert angegeben wurde.The DefaultValueAttribute sets the value that will be automatically assigned to the member if no value is specified.

Informationen zur Steuerung der XML-Serialisierung von codiertem SOAP finden Sie unter Attribute zur Steuerung der Serialisierung von codiertem SOAP.To control encoded SOAP XML serialization, see Attributes That Control Encoded SOAP Serialization.

Siehe auchSee also