Atributos que controlam a serialização XML

Você pode aplicar os atributos na tabela a seguir para classes e membros de classe para controlar a maneira pela qual 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 literais de estilo geradas por um serviço Web XML. Para obter mais informações sobre como aplicar esses atributos a um método de serviço Web XML, consulte Serialização XML com Serviços Web XML.

Para obter mais informações sobre os atributos, consulte Estendendo metadados por meio de atributos.

Atributo	Aplica-se a	Especifica
XmlAnyAttributeAttribute	O valor do campo público, propriedade, parâmetro ou retorno que retorna uma matriz de objetos XmlAttribute.	Ao desserializar, a matriz será preenchida com objetos XmlAttribute que representam todos os atributos XML desconhecidos do esquema.
XmlAnyElementAttribute	O valor do campo público, propriedade, parâmetro ou retorno que retorna uma matriz de objetos XmlElement.	Ao desserializar, a matriz será preenchida com objetos XmlElement que representam todos os elementos XML desconhecidos do esquema.
XmlArrayAttribute	O 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	O 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 XmlArrayAttribute.
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 ter a ambiguidade removida usando uma enumeração.
XmlElementAttribute	Campo público, propriedade, parâmetro ou valor de retorno.	O campo ou propriedade serão serializados como um elemento XML.
XmlEnumAttribute	O campo público que é um identificador de enumeração.	O nome do elemento de um membro de enumeração.
XmlIgnoreAttribute	Propriedades públicas e campos.	A propriedade ou campo devem ser ignorados quando a classe recipiente é serializada.
XmlIncludeAttribute	Declarações públicas de classe derivada e valores de retorno de métodos públicos para documentos da linguagem WSDL.	A classe deve ser incluída ao gerar esquemas (para serem reconhecidos quando serializados).
XmlRootAttribute	Declarações públicas de classe.	Controla a serialização XML do destino do atributo como um elemento raiz XML. Use o atributo para especificar ainda mais o namespace e o nome do elemento.
XmlTextAttribute	Propriedades públicas e campos.	A propriedade ou o campo devem ser serializados como texto XML.
XmlTypeAttribute	Declarações públicas de classe.	O nome e o namespace do tipo XML.

Além desses atributos, que são todos encontrados no namespace System.Xml.Serialization, você também pode aplicar o atributo System.ComponentModel.DefaultValueAttribute 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 de SOAP codificado, consulte Atributos que controlam a serialização SOAP codificada.

Consulte também

Tarefas

Como especificar um nome de elemento alternativo para um fluxo XML

Como serializar um objeto

Como desserializar um objeto

Referência

XmlSerializer

Conceitos

Controlando a serialização XML usando atributos

Outros recursos

Serialização XML e SOAP