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 estos atributos controlan 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 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 Extending Metadata Using Attributes.

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.

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

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

Vea también

Tareas

Cómo: Especificar un nombre de 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 de SOAP y XML