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 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 servicios Web XML, vea Serialización XML con servicios Web XML.

Para obtener más información acerca de los atributos, vea Extender metadatos mediante atributos.

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 a 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 a 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

Serialización XML y SOAP | XmlSerializer | Controlar la serialización XML mediante atributos | Reemplazar la serialización XML

  • Last updated on