Atributos que controlam a serialização XML
Você pode aplicar os atributos na tabela a seguir a classes e membros de classe para controlar a maneira como o XmlSerializer serializa ou desserializa uma instância da classe. Para entender como esses atributos controlam a serialização XML, consulte Controlando a serialização XML usando atributos.
Esses atributos também podem ser usados para controlar as mensagens SOAP de estilo literal geradas por um XML Web Service. Para obter mais informações sobre como aplicar esses atributos a um método XML Web Services, consulte XML Serialization with XML Web Services.
Para obter mais informações sobre atributos, consulte Atributos.
| Atributo | Aplica-se a | Especifica |
|---|---|---|
| XmlAnyAttributeAttribute | Campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de XmlAttribute objetos. | Ao desserializar, a matriz será preenchida com XmlAttribute objetos que representam todos os atributos XML desconhecidos para o esquema. |
| XmlAnyElementAttribute | Campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de XmlElement objetos. | Ao desserializar, a matriz é preenchida com XmlElement objetos que representam todos os elementos XML desconhecidos para o esquema. |
| XmlArrayAttribute | Campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de objetos complexos. | Os membros da matriz serão gerados como membros de uma matriz XML. |
| XmlArrayItemAttribute | Campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de objetos complexos. | Os tipos derivados que podem ser inseridos em uma matriz. Geralmente aplicado em conjunto com um XmlArrayAttributearquivo . |
| XmlAttributeAttribute | Campo público, propriedade, parâmetro ou valor de retorno. | O membro será serializado como um atributo XML. |
| XmlChoiceIdentifierAttribute | Campo público, propriedade, parâmetro ou valor de retorno. | O membro pode ser desambiguado usando uma enumeração. |
| XmlElementAttribute | Campo público, propriedade, parâmetro ou valor de retorno. | O campo ou propriedade será serializado como um elemento XML. |
| XmlEnumAttribute | Campo público que é um identificador de enumeração. | O nome do elemento de um membro de enumeração. |
| XmlIgnoreAttribute | Propriedades e campos públicos. | A propriedade ou campo deve ser ignorado quando a classe que contém é serializada. |
| XmlIncludeAttribute | Declarações de classe derivadas públicas e valores de retorno de métodos públicos para documentos WSDL (Web Services Description Language). | A classe deve ser incluída ao gerar esquemas (para ser reconhecida quando serializada). |
| XmlRootAttribute | Declarações de classe pública. | Controla a serialização XML do destino do atributo como um elemento raiz XML. Use o atributo para especificar melhor o namespace e o nome do elemento. |
| XmlTextAttribute | Propriedades e campos públicos. | A propriedade ou campo deve ser serializado como texto XML. |
| XmlTypeAttribute | Declarações de classe pública. | O nome e o namespace do tipo XML. |
| ObsoleteAttribute | Propriedades e campos públicos. | A propriedade ou campo será ignorado quando a classe que contém for serializada. |
Além desses atributos, que são todos encontrados no System.Xml.Serialization namespace, você também pode aplicar o DefaultValueAttribute atributo a um campo. O DefaultValueAttribute define o valor que será atribuído automaticamente ao membro se nenhum valor for especificado.
Para controlar a serialização XML SOAP codificada, consulte Atributos que controlam a serialização SOAP codificada.
