System.Xml.Serialization Namespace

Contém classes que são usadas para serializar objetos nos documentos ou fluxos de formato XML.

Classes

CodeExporter

Representa uma classe que pode gerar o código de proxy de uma representação XML de uma estrutura de dados.

CodeIdentifier

Fornece métodos estáticos para converter o texto de entrada em nomes de entidades de código.

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.

ImportContext

Descreve o contexto em que um conjunto de esquemas é associado às entidades de código do .NET.

SchemaImporter

Descreve um importador de esquema.

SoapAttributeAttribute

Especifica que o XmlSerializer deve serializar o membro de classe como um atributo SOAP codificado.

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.

SoapAttributes

Representa uma coleção de objetos de atributos que controlam como o XmlSerializer serializa e desserializa métodos SOAP.

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.

SoapElementAttribute

Especifica que o valor do membro público seja serializado pelo XmlSerializer como um elemento XML SOAP codificado.

SoapEnumAttribute

Controla como o XmlSerializer serializa um membro de enumeração.

SoapIgnoreAttribute

Instrui XmlSerializer para não serializar o campo público ou o valor da propriedade pública de leitura/gravação.

SoapIncludeAttribute

Permite que o XmlSerializer reconheça um tipo ao serializar ou desserializar um objeto como XML de SOAP codificado.

SoapReflectionImporter

Gera mapeamentos para mensagens codificadas em SOAP das informações do método de serviço Web ou tipos do .NET.

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.

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.

SoapSchemaMember

Representa determinados atributos de um elemento XSD <part> em um documento WSDL para gerar classes do documento.

SoapTypeAttribute

Controla o esquema gerado pelo XmlSerializer quando uma instância da classe é serializada como XML codificado em SOAP.

UnreferencedObjectEventArgs

Fornece dados para o objeto conhecido, mas não referenciado, encontrado em um fluxo XML de SOAP codificado durante a desserialização.

XmlAnyAttributeAttribute

Especifica que o membro (um campo que retorna uma matriz de objetos XmlAttribute) pode conter os atributos XML.

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.

XmlAnyElementAttributes

Representa uma coleção de objetos XmlAnyElementAttribute .

XmlArrayAttribute

Especifica que o XmlSerializer deve serializar um membro de classe específica como uma matriz de elementos XML.

XmlArrayItemAttribute

Representa um atributo que especifica os tipos derivados que o XmlSerializer pode colocar em uma matriz serializada.

XmlArrayItemAttributes

Representa uma coleção de objetos XmlArrayItemAttribute .

XmlAttributeAttribute

Especifica que o XmlSerializer deve serializar o membro de classe como um atributo XML.

XmlAttributeEventArgs

Fornece dados para o evento de UnknownAttribute .

XmlAttributeOverrides

Permite a substituição de propriedade, campo e atributos de classe quando você usa o XmlSerializer para serializar ou desserializar um objeto.

XmlAttributes

Representa uma coleção de objetos de atributos que controlam como o XmlSerializer serializa e desserializa um objeto.

XmlChoiceIdentifierAttribute

Especifica que o membro pode ser detectado ainda mais usando uma enumeração.

XmlCodeExporter

Gera tipos e declarações de atributos de informações de mapeamento de tipo interno para declarações de elemento de esquema XML.

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.

XmlElementAttributes

Representa uma coleção de objetos XmlElementAttribute usada pelo XmlSerializer para substituir a forma padrão que ele serializa uma classe.

XmlElementEventArgs

Fornece dados para o evento de UnknownElement .

XmlEnumAttribute

Controla como o XmlSerializer serializa um membro de enumeração.

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.

XmlIncludeAttribute

Permite que XmlSerializer reconheça um tipo quando ele serializa ou desserializa um objeto.

XmlMapping

Dá suporte a mapeamentos entre tipos .NET e os tipos de dados do esquema XML.

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).

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.

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.

XmlNodeEventArgs

Fornece dados para o evento de UnknownNode .

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.

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.

XmlRootAttribute

Controla a serialização XML do destino do atributo como um elemento raiz XML.

XmlSchemaEnumerator

Habilita iteração em uma coleção de objetos XmlSchema.

XmlSchemaExporter

Popula objetos XmlSchema com declarações de elemento de esquema XML que são encontradas em objetos de mapeamento de tipo.

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.

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.

XmlSchemas

Representa a coleção de esquemas XML.

XmlSerializationGeneratedCode

Uma classe abstrata que é a classe base para XmlSerializationReader e XmlSerializationWriter, e que contém os métodos comuns para ambos os tipos.

XmlSerializationReader

Controla a desserialização pela classe XmlSerializer.

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.

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.

XmlSerializationWriter

Representa uma classe abstrata usada para controlar a serialização pela classe XmlSerializer.

XmlSerializer

Serializa e desserializa objetos de e para documentos XML. O XmlSerializer permite controlar como os objetos são codificados em XML.

XmlSerializerAssemblyAttribute

Aplicado a um proxy do cliente de serviço Web, permite que você especifique um assembly que contém serializadores personalizados.

XmlSerializerFactory

Cria versões tipadas do XmlSerializer para obter uma serialização mais eficiente.

XmlSerializerImplementation

Define o leitor, o gravador e os métodos para serializadores tipados gerados previamente.

XmlSerializerNamespaces

Contém os namespaces e prefixos XML que o XmlSerializer usa para gerar nomes qualificados em uma instância de documento XML.

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.

XmlTextAttribute

Indica para o XmlSerializer que o membro deve ser tratado como texto XML quando a classe que o contém é serializada ou desserializada.

XmlTypeAttribute

Controla o esquema XML que é gerado quando o atributo de destino é serializado pelo XmlSerializer.

XmlTypeMapping

Contém um mapeamento de um tipo para outro.

Estruturas

XmlDeserializationEvents

Contém campos que podem ser usados para passar eventos delegados para um método Deserialize thread-safe do XmlSerializer.

Interfaces

IXmlSerializable

Fornece a formatação personalizada para serialização de XML e de desserialização.

IXmlTextParser

Estabelece uma propriedade Normalized para uso pela infraestrutura do .NET.

Enumerações

CodeGenerationOptions

Especifica várias opções a serem usadas ao gerar tipos .NET para uso com um serviço Web XML.

XmlMappingAccess

Especifica se um mapeamento é de leitura, gravação ou ambos.

Delegados

UnreferencedObjectEventHandler

Representa o método que manipula o evento UnreferencedObject de um XmlSerializer.

XmlAttributeEventHandler

Representa o método que manipula o UnknownAttribute.

XmlElementEventHandler

Representa o método que manipula o evento UnknownElement de um XmlSerializer.

XmlNodeEventHandler

Representa o método que manipula o evento UnknownNode de um 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.

XmlSerializationFixupCallback

Delegado usado pela classe XmlSerializer para desserialização de dados XML com codificação SOAP.

XmlSerializationReadCallback

Delegado usado pela classe XmlSerializer para desserialização de tipos de dados XML não raiz com codificação SOAP.

XmlSerializationWriteCallback

Delegado que é usado pela classe XmlSerializer para serialização de tipos de dados XML não raiz com codificação SOAP.

Comentários

A classe central no namespace é a XmlSerializer classe . Para usar essa classe, use o XmlSerializer construtor para criar uma instância da classe usando o tipo do objeto para serializar. Depois que um XmlSerializer for criado, crie uma instância do objeto para serializar. Você também deve criar um objeto para gravar o arquivo em um documento ou fluxo, como , StreamTextWriterou XmlWriter. Em seguida, você pode chamar o Serialize método para converter o objeto em um documento XML.

Para desserializar um objeto de um documento XML, crie um objeto adequado para ler o documento ou fluxo (novamente, um Stream, TextWriterou XmlWriter). Invoque o Deserialize método durante a conversão do objeto resultante para o tipo do objeto original (que foi serializado).

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. Por exemplo, se uma classe contiver um membro que será serializado como um elemento XML, você poderá aplicar o XmlElementAttribute atributo ao membro. Ao aplicar o atributo , você pode especificar detalhes como o nome real do elemento XML usando a ElementName propriedade . Para obter uma lista completa de todos os atributos, consulte a visão geral da XmlSerializer classe.