Atributos que controlan la serialización XML
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. Para entender cómo controlan estos atributos la serialización XML, vea Controlar la serialización XML mediante atributos.
Estos atributos también se pueden utilizar para controlar los mensajes SOAP de estilo literales generados por un servicio Web XML. 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.
Para obtener más información sobre atributos, vea Atributos.
| Atributo | Se aplica a | Especifica |
|---|---|---|
| XmlAnyAttributeAttribute | El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos XmlAttribute objects. | Al deserializar, la matriz estará llena de objetos XmlAttribute que representan todos los atributos XML desconocidos para el esquema. |
| XmlAnyElementAttribute | El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos XmlElement objects. | Al deserializar, la matriz estará llena de objetos XmlElement que representan todos los atributos XML desconocidos para el esquema |
| XmlArrayAttribute | El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos complejos. | Los miembros de la matriz se generarán como miembros de una matriz de XML. |
| XmlArrayItemAttribute | El campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos complejos. | Los tipos derivados que se pueden insertar en una matriz. Normalmente aplicado junto con un XmlArrayAttribute. |
| XmlAttributeAttribute | Campo público, propiedad, parámetro o valor devuelto. | El miembro se serializará como un atributo XML. |
| XmlChoiceIdentifierAttribute | Campo público, propiedad, parámetro o valor devuelto. | El miembro se puede desambiguar adicionalmente utilizando una enumeración. |
| XmlElementAttribute | Campo público, propiedad, parámetro o valor devuelto. | El campo o propiedad se serializará como un elemento XML. |
| XmlEnumAttribute | Campo público que es un identificador de enumeración. | Nombre de elemento del miembro de una enumeración. |
| XmlIgnoreAttribute | Propiedades públicas y campos. | Se debería omitir la propiedad o campo cuando se serializa la clase contenedora. |
| 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). | La clase debería estar incluida al generar los esquemas (para ser reconocido cuando se serializa). |
| XmlRootAttribute | Declaraciones de clase públicas. | Controla la serialización XML del destino de atributo como elemento raíz XML. Utilice el atributo para especificar el espacio de nombres y nombre de elemento. |
| XmlTextAttribute | Propiedades públicas y campos. | La propiedad o campo se debería serializar como texto XML. |
| XmlTypeAttribute | Declaraciones de clase públicas. | El nombre y espacio de nombres del tipo XML. |
| ObsoleteAttribute | Propiedades públicas y campos. | Se omitirá la propiedad o campo cuando se serialice la clase contenedora. |
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. DefaultValueAttribute establece el valor que se asignará automáticamente al miembro si no se especifica ningún valor.
Para controlar la serialización SOAP y XML codificada, vea Atributos que controlan la serialización SOAP codificada.
