Atributos que controlam a serialização XMLAttributes That Control XML Serialization

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.You can apply the attributes in the following table to classes and class members to control the way in which the XmlSerializer serializes or deserializes an instance of the class. Para entender como esses atributos controlam a serialização XML, consulte Controlando a serialização XML usando atributos.To understand how these attributes control XML serialization, see Controlling XML Serialization Using Attributes.

Esses atributos também podem ser usados para controlar as mensagens SOAP literais de estilo geradas por um serviço Web XML.These attributes can also be used to control the literal style SOAP messages generated by an XML Web service. 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.For more information about applying these attributes to an XML Web services method, see XML Serialization with XML Web Services.

Para obter mais informações sobre atributos, consulte Atributos.For more information about attributes, see Attributes.

AtributoAttribute Aplica-se aApplies to EspecificaSpecifies
XmlAnyAttributeAttribute O valor do campo público, propriedade, parâmetro ou retorno que retorna uma matriz de objetos XmlAttribute.Public field, property, parameter, or return value that returns an array of XmlAttribute objects. Ao desserializar, a matriz será preenchida com objetos XmlAttribute que representam todos os atributos XML desconhecidos do esquema.When deserializing, the array will be filled with XmlAttribute objects that represent all XML attributes unknown to the schema.
XmlAnyElementAttribute O valor do campo público, propriedade, parâmetro ou retorno que retorna uma matriz de objetos XmlElement.Public field, property, parameter, or return value that returns an array of XmlElement objects. Ao desserializar, a matriz será preenchida com objetos XmlElement que representam todos os elementos XML desconhecidos do esquema.When deserializing, the array is filled with XmlElement objects that represent all XML elements unknown to the schema.
XmlArrayAttribute O campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de objetos complexos.Public field, property, parameter, or return value that returns an array of complex objects. Os membros da matriz serão gerados como membros de uma matriz XML.The members of the array will be generated as members of an XML array.
XmlArrayItemAttribute O campo público, propriedade, parâmetro ou valor de retorno que retorna uma matriz de objetos complexos.Public field, property, parameter, or return value that returns an array of complex objects. Os tipos derivados que podem ser inseridos em uma matriz.The derived types that can be inserted into an array. Geralmente aplicado em conjunto com um XmlArrayAttribute.Usually applied in conjunction with an XmlArrayAttribute.
XmlAttributeAttribute Campo público, propriedade, parâmetro ou valor de retorno.Public field, property, parameter, or return value. O membro será serializado como um atributo XML.The member will be serialized as an XML attribute.
XmlChoiceIdentifierAttribute Campo público, propriedade, parâmetro ou valor de retorno.Public field, property, parameter, or return value. O membro pode ter a ambiguidade removida usando uma enumeração.The member can be further disambiguated by using an enumeration.
XmlElementAttribute Campo público, propriedade, parâmetro ou valor de retorno.Public field, property, parameter, or return value. O campo ou propriedade serão serializados como um elemento XML.The field or property will be serialized as an XML element.
XmlEnumAttribute O campo público que é um identificador de enumeração.Public field that is an enumeration identifier. O nome do elemento de um membro de enumeração.The element name of an enumeration member.
XmlIgnoreAttribute Propriedades públicas e campos.Public properties and fields. A propriedade ou campo devem ser ignorados quando a classe recipiente é serializada.The property or field should be ignored when the containing class is serialized.
XmlIncludeAttribute Declarações públicas de classe derivada e valores de retorno de métodos públicos para documentos da linguagem WSDL.Public derived class declarations, and return values of public methods for Web Services Description Language (WSDL) documents. A classe deve ser incluída ao gerar esquemas (para serem reconhecidos quando serializados).The class should be included when generating schemas (to be recognized when serialized).
XmlRootAttribute Declarações públicas de classe.Public class declarations. Controla a serialização XML do destino do atributo como um elemento raiz XML.Controls XML serialization of the attribute target as an XML root element. Use o atributo para especificar ainda mais o namespace e o nome do elemento.Use the attribute to further specify the namespace and element name.
XmlTextAttribute Propriedades públicas e campos.Public properties and fields. A propriedade ou o campo devem ser serializados como texto XML.The property or field should be serialized as XML text.
XmlTypeAttribute Declarações públicas de classe.Public class declarations. O nome e o namespace do tipo XML.The name and namespace of the XML type.

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.In addition to these attributes, which are all found in the System.Xml.Serialization namespace, you can also apply the DefaultValueAttribute attribute to a field. O DefaultValueAttribute definirá o valor que será atribuído automaticamente ao membro se nenhum valor for especificado.The DefaultValueAttribute sets the value that will be automatically assigned to the member if no value is specified.

Para controlar a serialização XML de SOAP codificada, consulte Atributos que controlam a serialização SOAP codificada.To control encoded SOAP XML serialization, see Attributes That Control Encoded SOAP Serialization.

Consulte tambémSee also