Partilhar via


System.Xml.Serialization Namespace

Contém classes usadas para serializar objetos em fluxos ou documentos de formato XML.

Classes

Nome Description
CodeExporter

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

CodeIdentifier

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

CodeIdentifiers

Mantém um grupo de nomes para entidades de código relacionadas ou mapeamentos de tipo que são gerados por . Infraestrutura de serialização XML do NET.

ImportContext

Descreve o contexto no qual um conjunto de esquemas está associado a entidades de código .NET.

SchemaImporter

Descreve um importador de esquema.

SoapAttributeAttribute

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

SoapAttributeOverrides

Permite substituir atributos aplicados a propriedades, campos e classes quando você usa um XmlSerializer para serializar ou desserializar um objeto como SOAP codificado.

SoapAttributes

Representa uma coleção de objetos de atributo que controlam como os XmlSerializer métodos SOAP serializam e desserializam.

SoapCodeExporter

Gera tipos e declarações de atributo a partir de informações internas de mapeamento de tipo para partes de mensagem codificadas em SOAP definidas em um documento WSDL.

SoapElementAttribute

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

SoapEnumAttribute

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

SoapIgnoreAttribute

Instrui o XmlSerializer a 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 quando serializa ou desserializa um objeto como SOAP XML codificado.

SoapReflectionImporter

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

SoapSchemaExporter

Popula objetos XmlSchema com definições de tipo de dados de esquema XML para tipos .NET serializados usando codificação SOAP.

SoapSchemaImporter

Usado no .NET Framework para gerar mapeamentos internos para tipos .NET para partes de mensagem 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 de classe é serializada como XML codificado em SOAP.

UnreferencedObjectEventArgs

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

XmlAnyAttributeAttribute

Especifica que o membro (um campo que retorna uma matriz de objetos XmlAttribute) pode conter quaisquer 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 tenha nenhum membro correspondente no objeto sendo serializado ou desserializado.

XmlAnyElementAttributes

Representa uma coleção de XmlAnyElementAttribute objetos.

XmlArrayAttribute

Especifica que o XmlSerializer deve serializar um membro de classe específico 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 XmlArrayItemAttribute objetos.

XmlAttributeAttribute

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

XmlAttributeEventArgs

Fornece dados para o evento UnknownAttribute.

XmlAttributeOverrides

Permite substituir atributos de propriedade, campo e classe ao usar a XmlSerializer serialização ou desserialização de um objeto.

XmlAttributes

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

XmlChoiceIdentifierAttribute

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

XmlCodeExporter

Gera tipos e declarações de atributo a partir de informações internas de mapeamento de tipo 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 XmlElementAttribute objetos usados pela XmlSerializer maneira padrão para substituir a maneira padrão como serializa uma classe.

XmlElementEventArgs

Fornece dados para o evento UnknownElement.

XmlEnumAttribute

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

XmlIgnoreAttribute

Instrui o método Serialize(TextWriter, Object) do XmlSerializer a não serializar o campo público ou o valor da propriedade pública de leitura/gravação.

XmlIncludeAttribute

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

XmlMapping

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

XmlMemberMapping

Mapeia uma entidade de código em um método de serviço Web .NET para um elemento em uma mensagem WSDL (Linguagem de Descrição dos Serviços Web).

XmlMembersMapping

Fornece mapeamentos entre métodos de serviço Web .NET e mensagens WSDL (Linguagem de Descrição de Serviços Web) definidas para serviços Web SOAP.

XmlNamespaceDeclarationsAttribute

Especifica que a propriedade de destino, o parâmetro, o valor retornado ou o membro da classe contém prefixos associados aos namespaces usados em um documento XML.

XmlNodeEventArgs

Fornece dados para o evento UnknownNode.

XmlReflectionImporter

Gera mapeamentos para declarações de elemento de esquema XML, incluindo partes de mensagem XSD (definição de esquema XML literal) em um documento WSDL (Linguagem de Descrição dos Serviços Web), para informações de tipos .NET ou método de serviço Web.

XmlReflectionMember

Fornece mapeamentos entre entidades de código em métodos de serviço Web .NET e o conteúdo de mensagens WSDL (Linguagem de Descrição dos Serviços Web) definidas para serviços Web SOAP.

XmlRootAttribute

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

XmlSchemaEnumerator

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

XmlSchemaExporter

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

XmlSchemaImporter

Gera mapeamentos internos para tipos .NET para declarações de elemento de esquema XML, incluindo partes literais de mensagem XSD 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 que contém métodos comuns a ambos os tipos.

XmlSerializationReader

Controla a desserialização pela XmlSerializer classe.

XmlSerializationReader.CollectionFixup

Contém uma XmlSerializationCollectionFixupCallback instância delegada, além das entradas do método; também fornece os parâmetros do método.

XmlSerializationReader.Fixup

Contém uma XmlSerializationFixupCallback instância delegada, além das entradas do método; também serve como o parâmetro para o método.

XmlSerializationWriter

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

XmlSerializer

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

XmlSerializerAssemblyAttribute

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

XmlSerializerFactory

Cria versões tipada da XmlSerializer serialização mais eficiente.

XmlSerializerImplementation

Define o leitor, o gravador e os métodos para serializadores pré-gerados e tipado.

XmlSerializerNamespaces

Contém os namespaces XML e os prefixos usados XmlSerializer 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 aumentar o desempenho, quando esse atributo é aplicado a um assembly.

XmlTextAttribute

Indica à 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 gerado quando o destino do atributo é serializado pelo XmlSerializer.

XmlTypeMapping

Contém um mapeamento de um tipo para outro.

Estruturas

Nome Description
XmlDeserializationEvents

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

Interfaces

Nome Description
IXmlSerializable

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

IXmlTextParser

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

Enumerações

Nome Description
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 é lido, gravado ou ambos.

Delegados

Nome Description
UnreferencedObjectEventHandler

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

XmlAttributeEventHandler

Representa o método que manipula o UnknownAttribute.

XmlElementEventHandler

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

XmlNodeEventHandler

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

XmlSerializationCollectionFixupCallback

Delegado usado pela XmlSerializer classe para desserialização de tipos de dados XML codificados em SOAP que são mapeados para coleções ou enumerações.

XmlSerializationFixupCallback

Delegado usado pela XmlSerializer classe para desserialização de dados XML codificados em SOAP.

XmlSerializationReadCallback

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

XmlSerializationWriteCallback

Delegar que é usado pela XmlSerializer classe para serialização de tipos de dados XML não raiz codificados em 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 a ser serializado. 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 um Stream, TextWriterou 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 a 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.