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 |
---|---|---|
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. |
|
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. |
|
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. |
|
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. |
|
Parámetro, propiedad, campo público o valor devuelto. |
El miembro se serializará como un atributo XML. |
|
Parámetro, propiedad, campo público o valor devuelto. |
Se puede eliminar la ambigüedad del miembro mediante una enumeración. |
|
Parámetro, propiedad, campo público o valor devuelto. |
El campo o la propiedad se serializará como un elemento XML. |
|
Campo público que es un identificador de enumeración. |
Nombre de elemento de un miembro de enumeración. |
|
Campos y propiedades públicos. |
Cuando se serializa la clase contenedora, debe omitirse el campo o la propiedad. |
|
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. |
|
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. |
|
Campos y propiedades públicos. |
El campo o la propiedad debe serializarse como texto XML. |
|
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
Conceptos
Controlar la serialización XML mediante atributos