Atributos que controlan la serialización XMLAttributes That Control XML Serialization

Se pueden aplicar atributos a clases y a miembros de clase en la siguiente tabla para controlar la manera en que XmlSerializer serializa o deserializa una instancia de la clase.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. Para entender cómo controlan estos atributos la serialización XML, vea Controlar la serialización XML mediante atributos.To understand how these attributes control XML serialization, see Controlling XML Serialization Using Attributes.

Estos atributos también se pueden utilizar para controlar los mensajes SOAP de estilo literales generados por un servicio Web XML.These attributes can also be used to control the literal style SOAP messages generated by an XML Web service. Para más información sobre la aplicación de estos atributos a un método de servicios web XML, vea Serialización XML con servicios web XML.For more information about applying these attributes to an XML Web services method, see XML Serialization with XML Web Services.

Para obtener más información sobre atributos, vea Atributos.For more information about attributes, see Attributes.

AtributoAttribute Se aplica aApplies to EspecificaSpecifies
XmlAnyAttributeAttribute El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos XmlAttribute objects.Public field, property, parameter, or return value that returns an array of XmlAttribute objects. Al deserializar, la matriz estará llena de objetos XmlAttribute que representan todos los atributos XML desconocidos para el esquema.When deserializing, the array will be filled with XmlAttribute objects that represent all XML attributes unknown to the schema.
XmlAnyElementAttribute El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos XmlElement objects.Public field, property, parameter, or return value that returns an array of XmlElement objects. Al deserializar, la matriz estará llena de objetos XmlElement que representan todos los atributos XML desconocidos para el esquemaWhen deserializing, the array is filled with XmlElement objects that represent all XML elements unknown to the schema.
XmlArrayAttribute El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos complejos.Public field, property, parameter, or return value that returns an array of complex objects. Los miembros de la matriz se generarán como miembros de una matriz de XML.The members of the array will be generated as members of an XML array.
XmlArrayItemAttribute El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos complejos.Public field, property, parameter, or return value that returns an array of complex objects. Los tipos derivados que se pueden insertar en una matriz.The derived types that can be inserted into an array. Normalmente aplicado junto con un XmlArrayAttribute.Usually applied in conjunction with an XmlArrayAttribute.
XmlAttributeAttribute Campo público, propiedad, parámetro o valor devuelto.Public field, property, parameter, or return value. El miembro se serializará como un atributo XML.The member will be serialized as an XML attribute.
XmlChoiceIdentifierAttribute Campo público, propiedad, parámetro o valor devuelto.Public field, property, parameter, or return value. El miembro se puede desambiguar adicionalmente utilizando una enumeración.The member can be further disambiguated by using an enumeration.
XmlElementAttribute Campo público, propiedad, parámetro o valor devuelto.Public field, property, parameter, or return value. El campo o propiedad se serializará como un elemento XML.The field or property will be serialized as an XML element.
XmlEnumAttribute Campo público que es un identificador de enumeración.Public field that is an enumeration identifier. Nombre de elemento del miembro de una enumeración.The element name of an enumeration member.
XmlIgnoreAttribute Propiedades públicas y campos.Public properties and fields. Se debería omitir la propiedad o campo cuando se serializa la clase contenedora.The property or field should be ignored when the containing class is serialized.
XmlIncludeAttribute Declaraciones de clase derivada públicas y valores devueltos de métodos públicos para los documentos de lenguaje de descripción de servicios Web (WSDL).Public derived class declarations, and return values of public methods for Web Services Description Language (WSDL) documents. La clase debería estar incluida al generar los esquemas (para ser reconocido cuando se serializa).The class should be included when generating schemas (to be recognized when serialized).
XmlRootAttribute Declaraciones de clase públicas.Public class declarations. Controla la serialización XML del destino de atributo como elemento raíz XML.Controls XML serialization of the attribute target as an XML root element. Utilice el atributo para especificar el espacio de nombres y nombre de elemento.Use the attribute to further specify the namespace and element name.
XmlTextAttribute Propiedades públicas y campos.Public properties and fields. La propiedad o campo se debería serializar como texto XML.The property or field should be serialized as XML text.
XmlTypeAttribute Declaraciones de clase públicas.Public class declarations. El nombre y espacio de nombres del tipo XML.The name and namespace of the XML type.

Además de estos atributos, que se encuentran todos en el espacio de nombres System.Xml.Serialization también se puede aplicar el atributo DefaultValueAttribute a un campo.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. DefaultValueAttribute establece el valor que se asignará automáticamente al miembro si no se especifica ningún valor.The DefaultValueAttribute sets the value that will be automatically assigned to the member if no value is specified.

Para controlar la serialización SOAP y XML codificada, vea Atributos que controlan la serialización SOAP codificada.To control encoded SOAP XML serialization, see Attributes That Control Encoded SOAP Serialization.

Vea tambiénSee also