Compartilhar via

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 de estilo literal 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 Campo público, propriedade, parâmetro ou valor retornado 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 retornado 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 retornado 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 retornado que retorna uma matriz de objetos complexos. Os tipos derivados que podem ser inseridos em uma matriz. Normalmente aplicado em conjunto com um XmlArrayAttribute.
XmlAttributeAttribute Campo público, propriedade, parâmetro ou valor retornado. O membro será serializado como um atributo XML.
XmlChoiceIdentifierAttribute Campo público, propriedade, parâmetro ou valor retornado. O membro pode ser desambiguado ainda mais usando uma enumeração.
XmlElementAttribute Campo público, propriedade, parâmetro ou valor retornado. O campo ou a propriedade será serializada 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 devem ser ignorados quando a classe recipiente é serializada.
XmlIncludeAttribute Declarações de classes públicas derivadas e valores de retorno de métodos públicos em documentos WSDL (Linguagem de Descrição de Serviços Web). A classe deve ser incluída na geração de esquemas (para ser reconhecida quando serializada).
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 e campos públicos. A propriedade ou o campo deve ser serializado como texto XML.
XmlTypeAttribute Declarações públicas de classe. O nome e o namespace do tipo XML.
ObsoleteAttribute Propriedades e campos públicos. A propriedade ou campo serão ignorados quando a classe recipiente 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 SOAP XML codificada, consulte Atributos que controlam a serialização SOAP codificada.

Consulte também

  • Last updated on