System.Xml.Serialization Namespace
Contém classes que são usadas para serializar objetos nos documentos ou fluxos de formato XML. Contains classes that are used to serialize objects into XML format documents or streams.
Classes
| CodeExporter |
Representa uma classe que pode gerar o código de proxy de uma representação XML de uma estrutura de dados.Represents a class that can generate proxy code from an XML representation of a data structure. |
| CodeIdentifier |
Fornece métodos estáticos para converter o texto de entrada em nomes de entidades de código.Provides static methods to convert input text into names for code entities. |
| CodeIdentifiers |
Mantém um grupo de nomes para entidades de código relacionadas ou mapeamentos de tipo gerados pela infraestrutura de serialização de XML do .NET.Maintains a group of names for related code entities or type mappings that are generated by .NET's XML serialization infrastructure. |
| ImportContext |
Descreve o contexto em que um conjunto de esquemas é associado às entidades de código do .NET.Describes the context in which a set of schema is bound to .NET code entities. |
| SchemaImporter |
Descreve um importador de esquema.Describes a schema importer. |
| SoapAttributeAttribute |
Especifica que o XmlSerializer deve serializar o membro de classe como um atributo SOAP codificado.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute. |
| SoapAttributeOverrides |
Permite substituir os atributos aplicados a propriedades, campos e classes quando se utiliza um XmlSerializer para serializar ou desserializar um objeto como codificado em SOAP.Allows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP. |
| SoapAttributes |
Representa uma coleção de objetos de atributos que controlam como o XmlSerializer serializa e desserializa métodos SOAP.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods. |
| SoapCodeExporter |
Gera declarações de atributo e tipos de informações de mapeamento de tipo interno para partes de mensagens codificadas em SOAP definidas em um documento WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document. |
| SoapElementAttribute |
Especifica que o valor do membro público seja serializado pelo XmlSerializer como um elemento XML SOAP codificado.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element. |
| SoapEnumAttribute |
Controla como o XmlSerializer serializa um membro de enumeração.Controls how the XmlSerializer serializes an enumeration member. |
| SoapIgnoreAttribute |
Instrui XmlSerializer para não serializar o campo público ou o valor da propriedade pública de leitura/gravação.Instructs the XmlSerializer not to serialize the public field or public read/write property value. |
| SoapIncludeAttribute |
Permite que o XmlSerializer reconheça um tipo ao serializar ou desserializar um objeto como XML de SOAP codificado.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML. |
| SoapReflectionImporter |
Gera mapeamentos para mensagens codificadas em SOAP das informações do método de serviço Web ou tipos do .NET.Generates mappings to SOAP-encoded messages from .NET types or Web service method information. |
| SoapSchemaExporter |
Preenche objetos XmlSchema com definições de tipo de dados de esquema XML para tipos do .NET Framework serializados usando a codificação SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding. |
| SoapSchemaImporter |
Usado dentro do .NET Framework para gerar mapeamentos internos para tipos do .NET Framework de partes de mensagens codificadas em SOAP em um documento WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document. |
| SoapSchemaMember |
Representa determinados atributos de um elemento XSD < |
| SoapTypeAttribute |
Controla o esquema gerado pelo XmlSerializer quando uma instância da classe é serializada como XML codificado em SOAP.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML. |
| UnreferencedObjectEventArgs |
Fornece dados para o objeto conhecido, mas não referenciado, encontrado em um fluxo XML de SOAP codificado durante a desserialização.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization. |
| XmlAnyAttributeAttribute |
Especifica que o membro (um campo que retorna uma matriz de objetos XmlAttribute) pode conter os atributos XML.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes. |
| XmlAnyElementAttribute |
Especifica que o membro (um campo que retorna uma matriz de objetos XmlElement ou XmlNode) contém objetos que representam qualquer elemento XML que não tem nenhum membro correspondente no objeto que está sendo serializado ou desserializado.Specifies that the member (a field that returns an array of XmlElement or XmlNode objects) contains objects that represent any XML element that has no corresponding member in the object being serialized or deserialized. |
| XmlAnyElementAttributes |
Representa uma coleção de objetos XmlAnyElementAttribute .Represents a collection of XmlAnyElementAttribute objects. |
| XmlArrayAttribute |
Especifica que o XmlSerializer deve serializar um membro de classe específica como uma matriz de elementos XML.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements. |
| XmlArrayItemAttribute |
Representa um atributo que especifica os tipos derivados que o XmlSerializer pode colocar em uma matriz serializada.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array. |
| XmlArrayItemAttributes |
Representa uma coleção de objetos XmlArrayItemAttribute .Represents a collection of XmlArrayItemAttribute objects. |
| XmlAttributeAttribute |
Especifica que o XmlSerializer deve serializar o membro de classe como um atributo XML.Specifies that the XmlSerializer must serialize the class member as an XML attribute. |
| XmlAttributeEventArgs |
Fornece dados para o evento de UnknownAttribute .Provides data for the UnknownAttribute event. |
| XmlAttributeOverrides |
Permite a substituição de propriedade, campo e atributos de classe quando você usa o XmlSerializer para serializar ou desserializar um objeto.Allows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object. |
| XmlAttributes |
Representa uma coleção de objetos de atributos que controlam como o XmlSerializer serializa e desserializa um objeto.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object. |
| XmlChoiceIdentifierAttribute |
Especifica que o membro pode ser detectado ainda mais usando uma enumeração.Specifies that the member can be further detected by using an enumeration. |
| XmlCodeExporter |
Gera tipos e declarações de atributos de informações de mapeamento de tipo interno para declarações de elemento de esquema XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations. |
| XmlElementAttribute |
Indica que um campo ou propriedade pública representa um elemento XML quando o XmlSerializer serializa ou desserializa o objeto que o contém.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it. |
| XmlElementAttributes |
Representa uma coleção de objetos XmlElementAttribute usada pelo XmlSerializer para substituir a forma padrão que ele serializa uma classe.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class. |
| XmlElementEventArgs |
Fornece dados para o evento de UnknownElement .Provides data for the UnknownElement event. |
| XmlEnumAttribute |
Controla como o XmlSerializer serializa um membro de enumeração.Controls how the XmlSerializer serializes an enumeration member. |
| XmlIgnoreAttribute |
Instrui o método Serialize(TextWriter, Object) do XmlSerializer para não serializar o campo público ou o valor da propriedade pública de leitura/gravação.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value. |
| XmlIncludeAttribute |
Permite que XmlSerializer reconheça um tipo quando ele serializa ou desserializa um objeto.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object. |
| XmlMapping |
Dá suporte a mapeamentos entre tipos .NET e os tipos de dados do esquema XML.Supports mappings between .NET types and XML Schema data types. |
| XmlMemberMapping |
Mapeia uma entidade de código em um método de serviço Web do .NET para um elemento em uma mensagem de WSDL (linguagem WSDL).Maps a code entity in a .NET Web service method to an element in a Web Services Description Language (WSDL) message. |
| XmlMembersMapping |
Fornece os mapeamentos entre os métodos do serviço Web do .NET e as mensagens de WSDL (linguagem WSDL) que são definidas para os serviços Web SOAP.Provides mappings between .NET Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services. |
| XmlNamespaceDeclarationsAttribute |
Especifica que a propriedade de destino, parâmetro, o valor retornado ou o membro da classe contém prefixos associados a namespaces que são usados em um documento XML.Specifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document. |
| XmlNodeEventArgs |
Fornece dados para o evento de UnknownNode .Provides data for the UnknownNode event. |
| XmlReflectionImporter |
Gera mapeamentos de declarações de elemento de esquema XML, incluindo partes de mensagem de XSD (definição de esquema XML) literais em um documento de linguagem WSDL, para tipos .NET ou informações de método de serviço Web.Generates mappings to XML schema element declarations, including literal XML Schema Definition (XSD) message parts in a Web Services Description Language (WSDL) document, for .NET types or Web service method information. |
| XmlReflectionMember |
Fornece os mapeamentos entre as entidades de código nos métodos de serviço Web do .NET e o conteúdo das mensagens de linguagem WSDL que são definidos para serviços Web SOAP.Provides mappings between code entities in .NET Web service methods and the content of Web Services Description Language (WSDL) messages that are defined for SOAP Web services. |
| XmlRootAttribute |
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. |
| XmlSchemaEnumerator |
Habilita iteração em uma coleção de objetos XmlSchema.Enables iteration over a collection of XmlSchema objects. |
| XmlSchemaExporter |
Popula objetos XmlSchema com declarações de elemento de esquema XML que são encontradas em objetos de mapeamento de tipo.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects. |
| XmlSchemaImporter |
Gera mapeamentos internos para os tipos .NET para declarações de elemento do esquema XML, incluindo partes de mensagens XSD literais em um documento WSDL.Generates internal mappings to .NET types for XML schema element declarations, including literal XSD message parts in a WSDL document. |
| XmlSchemaProviderAttribute |
Quando aplicado a um tipo, armazena o nome de um método estático do tipo que retorna um esquema XML e um XmlQualifiedName (ou XmlSchemaType para tipos anônimos) que controla a serialização do tipo.When applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName (or XmlSchemaType for anonymous types) that controls the serialization of the type. |
| XmlSchemas |
Representa a coleção de esquemas XML.Represents the collection of XML schemas. |
| XmlSerializationGeneratedCode |
Uma classe abstrata que é a classe base para XmlSerializationReader e XmlSerializationWriter, e que contém os métodos comuns para ambos os tipos.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types. |
| XmlSerializationReader |
Controla a desserialização pela classe XmlSerializer.Controls deserialization by the XmlSerializer class. |
| XmlSerializationReader.CollectionFixup |
Contém uma instância de delegado XmlSerializationCollectionFixupCallback e as entradas do método, fornecendo também os parâmetro do método.Holds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters. |
| XmlSerializationReader.Fixup |
Contém uma instância de delegado XmlSerializationFixupCallback e as entradas do método, servindo também como o parâmetro do método.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method. |
| XmlSerializationWriter |
Representa uma classe abstrata usada para controlar a serialização pela classe XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class. |
| XmlSerializer |
Serializa e desserializa objetos de e para documentos XML.Serializes and deserializes objects into and from XML documents. O XmlSerializer permite controlar como os objetos são codificados em XML.The XmlSerializer enables you to control how objects are encoded into XML. |
| XmlSerializerAssemblyAttribute |
Aplicado a um proxy do cliente de serviço Web, permite que você especifique um assembly que contém serializadores personalizados.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers. |
| XmlSerializerFactory |
Cria versões tipadas do XmlSerializer para obter uma serialização mais eficiente.Creates typed versions of the XmlSerializer for more efficient serialization. |
| XmlSerializerImplementation |
Define o leitor, o gravador e os métodos para serializadores tipados gerados previamente.Defines the reader, writer, and methods for pre-generated, typed serializers. |
| XmlSerializerNamespaces |
Contém os namespaces e prefixos XML que o XmlSerializer usa para gerar nomes qualificados em uma instância de documento XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance. |
| XmlSerializerVersionAttribute |
Significa que o código foi gerado pela infraestrutura de serialização e pode ser reutilizado para melhorar o desempenho, quando esse atributo é aplicado a um assembly.Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly. |
| XmlTextAttribute |
Indica para o XmlSerializer que o membro deve ser tratado como texto XML quando a classe que o contém é serializada ou desserializada.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized. |
| XmlTypeAttribute |
Controla o esquema XML que é gerado quando o atributo de destino é serializado pelo XmlSerializer.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer. |
| XmlTypeMapping |
Contém um mapeamento de um tipo para outro.Contains a mapping of one type to another. |
Estruturas
| XmlDeserializationEvents |
Contém campos que podem ser usados para passar eventos delegados para um método Deserialize thread-safe do XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer. |
Interfaces
| IXmlSerializable |
Fornece a formatação personalizada para serialização de XML e de desserialização.Provides custom formatting for XML serialization and deserialization. |
| IXmlTextParser |
Estabelece uma propriedade Normalized para uso pela infraestrutura do .NET.Establishes a Normalized property for use by the .NET infrastructure. |
Enumerações
| CodeGenerationOptions |
Especifica várias opções a serem usadas ao gerar tipos .NET para uso com um serviço Web XML.Specifies various options to use when generating .NET types for use with an XML Web Service. |
| XmlMappingAccess |
Especifica se um mapeamento é de leitura, gravação ou ambos.Specifies whether a mapping is read, write, or both. |
Delegados
| UnreferencedObjectEventHandler |
Representa o método que manipula o evento UnreferencedObject de um XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer. |
| XmlAttributeEventHandler |
Representa o método que manipula o UnknownAttributeRepresents the method that handles the UnknownAttribute |
| XmlElementEventHandler |
Representa o método que manipula o evento UnknownElement de um XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer. |
| XmlNodeEventHandler |
Representa o método que manipula o evento UnknownNode de um XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer. |
| XmlSerializationCollectionFixupCallback |
Delegado usado pela classe XmlSerializer para desserialização de tipos de dados XML com codificação SOAP que são mapeados para coleções ou enumerações.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations. |
| XmlSerializationFixupCallback |
Delegado usado pela classe XmlSerializer para desserialização de dados XML com codificação SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data. |
| XmlSerializationReadCallback |
Delegado usado pela classe XmlSerializer para desserialização de tipos de dados XML não raiz com codificação SOAP.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data. |
| XmlSerializationWriteCallback |
Delegado que é usado pela classe XmlSerializer para serialização de tipos de dados XML não raiz com codificação SOAP.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data. |
Comentários
A classe central no namespace é a XmlSerializer classe.The central class in the namespace is the XmlSerializer class. Para usar essa classe, use o XmlSerializer construtor para criar uma instância da classe usando o tipo do objeto a ser serializado.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Depois que um XmlSerializer for criado, crie uma instância do objeto para serializar.Once an XmlSerializer is created, create an instance of the object to serialize. Você também deve criar um objeto para gravar o arquivo em um documento ou fluxo, como um Stream , TextWriter ou XmlWriter .You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. Em seguida, você pode chamar o Serialize método para converter o objeto em um documento XML.You can then call the Serialize method to convert the object into an XML document.
Para desserializar um objeto de um documento XML, crie um objeto adequado para ler o documento ou fluxo (novamente, um Stream , TextWriter ou XmlWriter ).To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Invoque o Deserialize método durante a conversão do objeto resultante para o tipo do objeto original (que foi serializado).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).
Para controlar ainda mais a serialização, o System.Xml.Serialization namespace contém várias Attribute classes que podem ser aplicadas aos membros de uma classe.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Por exemplo, se uma classe contiver um membro que será serializado como um elemento XML, você poderá aplicar o XmlElementAttribute atributo ao membro.For example, if a class contains a member that will be serialized as an XML element, you can apply the XmlElementAttribute attribute to the member. Ao aplicar o atributo, você pode especificar detalhes como o nome real do elemento XML usando a ElementName propriedade.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Para obter uma lista completa de todos os atributos, consulte a XmlSerializer visão geral da classe.For a complete list of all the attributes, see the XmlSerializer class overview.