Partilhar via

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 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. Pode-se desambiguar o membro através de 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 a contém é serializada.
XmlIncludeAttribute Declarações de classes públicas derivadas e valores de retorno de métodos públicos para documentos de Linguagem de Descrição de Serviços Web (WSDL). A classe deve ser incluída ao gerar 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 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 públicas de classe O nome e o namespace do tipo XML.
ObsoleteAttribute Propriedades e campos públicos. Quando a classe que contém o objeto for serializada, a propriedade ou campo será ignorado.

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.

Ver também

  • Last updated on