Share via


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 XmlSerializer serializa o deserializa una instancia de la clase. Para conocer la forma en que estos atributos controlan la serialización XML, vea Controlar la serialización XML mediante atributos.

Estos atributos también pueden utilizarse para controlar los mensajes SOAP de estilo literal que genera un servicio Web XML. Para obtener más información sobre cómo aplicar estos atributos a un método de servicio Web XML, vea Serialización XML con servicios Web XML.

Para obtener más información acerca de los atributos, vea Extending Metadata Using Attributes.

Atributo Se aplica a Especifica

XmlAnyAttributeAttribute

Campo público, propiedad, parámetro o valor devuelto que devuelve una matriz de objetos XmlAttribute.

Al deserializar, la matriz se rellenará con objetos XmlAttribute 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 objetos XmlElement.

Al deserializar, la matriz se rellenará con objetos XmlElement 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.

Los tipos derivados que pueden insertarse en una matriz. Normalmente se aplica junto con XmlArrayAttribute.

XmlAttributeAttribute

Parámetro, propiedad, campo público o valor devuelto.

El miembro se serializará como un atributo XML.

XmlChoiceIdentifierAttribute

Parámetro, propiedad, campo público o valor devuelto.

Se puede eliminar la ambigüedad del miembro mediante una enumeración.

XmlElementAttribute

Parámetro, propiedad, campo público o valor devuelto.

El campo o la propiedad se serializará 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

Campos y propiedades públicos.

Cuando se serializa la clase contenedora, debe omitirse el campo o la propiedad.

XmlIncludeAttribute

Declaraciones de clases derivadas y públicas, así como valores devueltos de métodos públicos para documentos del Lenguaje de descripción de servicios Web (WSDL).

La clase debe incluirse al generar esquemas de modo que sea reconocida durante la serialización.

XmlRootAttribute

Declaraciones de clase pública.

Controla la serialización XML del atributo de destino como un elemento raíz XML. Utilice el atributo para especificar más detalladamente el espacio de nombres y el nombre de elemento.

XmlTextAttribute

Campos y propiedades públicos.

El campo o la propiedad debe serializarse como texto XML.

XmlTypeAttribute

Declaraciones de clase pública.

El nombre y el espacio de nombres del tipo XML.

Además de estos atributos, que se encuentran en el espacio de nombres System.Xml.Serialization, también puede aplicar el atributo System.ComponentModel.DefaultValueAttribute a un campo. DefaultValueAttribute establece el valor que se asignará automáticamente al miembro si no se especifica un valor.

Para controlar la serialización XML SOAP codificada, vea Atributos que controlan la serialización SOAP codificada.

Vea también

Tareas

Cómo especificar el nombre de un elemento alternativo para una secuencia XML
Cómo serializar un objeto
Cómo deserializar un objeto

Referencia

XmlSerializer

Conceptos

Controlar la serialización XML mediante atributos

Otros recursos

Serialización XML y SOAP