Compartir a través de

Atributos que controlan la serialización XML

Puede aplicar los atributos de la tabla siguiente a clases y miembros de clase para controlar la forma en que serializa XmlSerializer o deserializa una instancia de la clase. Para comprender cómo estos atributos controlan la serialización XML, consulte Control de la serialización XML mediante atributos.

Estos atributos también se pueden usar para controlar los mensajes SOAP de estilo literal generados por un servicio web XML. Para obtener más información sobre cómo aplicar 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 los atributos, vea Atributos.

Atributo Se aplica a Especifica
XmlAnyAttributeAttribute Campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de XmlAttribute objetos. Al deserializar, la matriz se rellenará con XmlAttribute objetos que representan todos los atributos XML desconocidos para el esquema.
XmlAnyElementAttribute Campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de XmlElement objetos. Al deserializar, la matriz se rellena con XmlElement objetos que representan todos los elementos XML desconocidos para el esquema.
XmlArrayAttribute 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 XML.
XmlArrayItemAttribute Campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos complejos. Tipos derivados que se pueden insertar en una matriz. Normalmente se aplica junto con 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 aún más mediante una enumeración.
XmlElementAttribute Campo público, propiedad, parámetro o valor devuelto. El campo o la propiedad se serializarán como un elemento XML.
XmlEnumAttribute Campo público que es un identificador de enumeración. Nombre de elemento de un miembro de enumeración.
XmlIgnoreAttribute Propiedades y campos públicos. La propiedad o el campo deben omitirse cuando se serializa la clase contenedora.
XmlIncludeAttribute Declaraciones de clases derivadas públicas y valores devueltos de métodos públicos en documentos del Lenguaje de descripción de servicios web (WSDL). La clase debe incluirse al generar esquemas para que se reconozcan cuando se serialicen.
XmlRootAttribute Declaraciones de clase públicas. Controla la serialización XML del destino del atributo como un elemento raíz XML. Use el atributo para especificar aún más el espacio de nombres y el nombre del elemento.
XmlTextAttribute Propiedades y campos públicos. La propiedad o el campo se deben serializar como texto XML.
XmlTypeAttribute Declaraciones de clase públicas. El nombre y espacio de nombres del tipo XML.
ObsoleteAttribute Propiedades y campos públicos. La propiedad o el campo se omitirán cuando se serialice la clase contenedora.

Además de estos atributos, que se encuentran en el System.Xml.Serialization espacio de nombres, también puede aplicar el DefaultValueAttribute atributo 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 XML codificada, vea Atributos que controlan la serialización SOAP codificada.

Consulte también