Atributos que controlam a serialização XML

  • Artigo

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ços Web XML, consulte Serialização XML com serviços Web XML.

Para obter mais informações sobre atributos, consulte 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.
ObsoleteAttribute Propriedades públicas e campos. A propriedade ou campo serão ignorados quando a classe recipiente for serializada.

Além desses atributos, que são todos encontrados no namespace System.Xml.Serialization, você também pode aplicar o atributo DefaultValueAttribute a um campo. O DefaultValueAttribute definirá o valor que será atribuído automaticamente ao membro se nenhum valor for especificado.

Para controlar a serialização XML de SOAP codificada, consulte Atributos que controlam a serialização SOAP codificada.

Confira também