Atributos que controlan la serialización XML

  • Artículo

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.

Vea también