System.Xml.Serialization Espaço de Nomes

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

Classes

Name Description
CodeExporter

Representa uma classe que pode gerar código proxy a partir 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 tipos gerados pela infraestrutura de serialização XML do .NET.

ImportContext

Descreve o contexto em que um conjunto de esquemas está ligado a entidades de código .NET.

SchemaImporter

Descreve um importador de esquemas.

SoapAttributeAttribute

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

SoapAttributeOverrides

Permite sobrepor atributos aplicados a propriedades, campos e classes quando usas um XmlSerializer para serializar ou desserializar um objeto como SOAP codificado.

SoapAttributes

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

SoapCodeExporter

Gera tipos e declarações de atributos a partir da informação interna de mapeamento de tipos para partes de mensagens codificadas em SOAP definidas num documento WSDL.

SoapElementAttribute

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

SoapEnumAttribute

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

SoapIgnoreAttribute

Instrui a XmlSerializer não serializar o campo público ou o valor da propriedade pública.

SoapIncludeAttribute

Permite reconhecer XmlSerializer um tipo quando serializa ou desserializa um objeto como SOAP XML codificado.

SoapReflectionImporter

Gera mapeamentos para mensagens codificadas em SOAP a partir de tipos .NET ou informação de métodos de serviço Web.

SoapSchemaExporter

Preenche objetos XmlSchema com definições de tipos de dados XML Schema para .NET tipos que são serializados usando codificação SOAP.

SoapSchemaImporter

Utilizado no .NET Framework para gerar mapeamentos internos para tipos .NET para partes de mensagens codificadas em SOAP num documento WSDL.

SoapSchemaMember

Representa certos atributos de um elemento XSD <part> num documento WSDL para gerar classes a partir do documento.

SoapTypeAttribute

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

UnreferencedObjectEventArgs

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

XmlAnyAttributeAttribute

Especifica que o membro (um campo que devolve um array de XmlAttribute objetos) pode conter quaisquer atributos XML.

XmlAnyElementAttribute

Especifica que o membro (um campo que devolve um array de XmlElement ou XmlNode objetos) contém objetos que representam qualquer elemento XML que não tenha um membro correspondente no objeto a ser serializado ou desserializado.

XmlAnyElementAttributes

Representa uma coleção de XmlAnyElementAttribute objetos.

XmlArrayAttribute

Especifica que deve XmlSerializer serializar um determinado membro de classe como um array de elementos XML.

XmlArrayItemAttribute

Representa um atributo que especifica os tipos derivados que podem XmlSerializer colocar num array serializado.

XmlArrayItemAttributes

Representa uma coleção de XmlArrayItemAttribute objetos.

XmlAttributeAttribute

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

XmlAttributeEventArgs

Fornece dados para o UnknownAttribute evento.

XmlAttributeOverrides

Permite sobrepor atributos de propriedade, campo e classe quando usas o XmlSerializer para serializar ou desserializar um objeto.

XmlAttributes

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

XmlChoiceIdentifierAttribute

Especifica que o membro pode ser detetado adicionalmente através de uma enumeração.

XmlCodeExporter

Gera tipos e declarações de atributos a partir da informação interna de mapeamento de tipos para declarações de elementos de esquema XML.

XmlElementAttribute

Indica que um campo ou propriedade pública representa um elemento XML quando serializa XmlSerializer ou desserializa o objeto que o contém.

XmlElementAttributes

Representa uma coleção de XmlElementAttribute objetos usados para XmlSerializer substituir a forma padrão como serializa uma classe.

XmlElementEventArgs

Fornece dados para o UnknownElement evento.

XmlEnumAttribute

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

XmlIgnoreAttribute

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

XmlIncludeAttribute

Permite reconhecer XmlSerializer um tipo quando serializa ou desserializa um objeto.

XmlMapping

Suporta mapeamentos entre tipos .NET e tipos de dados XML Schema.

XmlMemberMapping

Mapeia uma entidade de código num método de serviço Web .NET para um elemento numa mensagem da Web Services Description Language (WSDL).

XmlMembersMapping

Fornece mapeamentos entre métodos de serviço Web .NET e mensagens da Web Services Description Language (WSDL) definidas para serviços Web SOAP.

XmlNamespaceDeclarationsAttribute

Especifica que a propriedade de destino, parâmetro, valor de retorno ou membro de classe contém prefixos associados a namespaces usados dentro de um documento XML.

XmlNodeEventArgs

Fornece dados para o UnknownNode evento.

XmlReflectionImporter

Gera mapeamentos para declarações de elementos de esquema XML, incluindo partes literais de mensagens XML Schema Definition (XSD) num documento Web Services Description Language (WSDL), para tipos .NET ou informação de métodos Web Service.

XmlReflectionMember

Fornece mapeamentos entre entidades de código em métodos de serviço Web .NET e o conteúdo das mensagens da Web Services Description Language (WSDL) definidas para serviços Web SOAP.

XmlRootAttribute

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

XmlSchemaEnumerator

Permite a iteração sobre uma coleção de XmlSchema objetos.

XmlSchemaExporter

Preenche XmlSchema objetos com declarações de elementos de esquema XML que se encontram em objetos de mapeamento de tipos.

XmlSchemaImporter

Gera mapeamentos internos para tipos .NET para declarações de elementos de esquema XML, incluindo partes literais de mensagens XSD num documento WSDL.

XmlSchemaProviderAttribute

Quando aplicado a um tipo, armazena o nome de um método estático do tipo que devolve 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 métodos comuns a ambos os tipos.

XmlSerializationReader

Controla a desserialização por classe XmlSerializer .

XmlSerializationReader.CollectionFixup

Detém uma XmlSerializationCollectionFixupCallback instância de delegado, mais as entradas do método; também fornece os parâmetros do método.

XmlSerializationReader.Fixup

Detém uma XmlSerializationFixupCallback instância de delegado, mais as entradas do método; também serve como 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 em e a partir de documentos XML. Permite-te XmlSerializer controlar como os objetos são codificados em XML.

XmlSerializerAssemblyAttribute

Aplicado a um proxy cliente de serviço Web, permite-lhe especificar um assembly que contenha serializadores personalizados.

XmlSerializerFactory

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

XmlSerializerImplementation

Define o leitor, o escritor e métodos para serializadores pré-gerados e tipados.

XmlSerializerNamespaces

Contém os espaços de nomes XML e prefixos que utiliza XmlSerializer para gerar nomes qualificados numa instância de documento XML.

XmlSerializerVersionAttribute

Indica que o código foi gerado pela infraestrutura de serialização e pode ser reutilizado para maior desempenho, quando este atributo é aplicado a uma assembleia.

XmlTextAttribute

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

XmlTypeAttribute

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

XmlTypeMapping

Contém um mapeamento de um tipo para outro.

Estruturas

Name Description
XmlDeserializationEvents

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

Interfaces

Name Description
IXmlSerializable

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

IXmlTextParser

Estabelece uma propriedade Normalized para utilização pela infraestrutura .NET.

Enumerações

Name Description
CodeGenerationOptions

Especifica várias opções para usar ao gerar tipos .NET para uso com um Serviço Web XML.

XmlMappingAccess

Especifica se um mapeamento é lido, escrito ou ambos.

Delegados

Name Description
UnreferencedObjectEventHandler

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

XmlAttributeEventHandler

Representa o método que lida com o UnknownAttribute.

XmlElementEventHandler

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

XmlNodeEventHandler

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

XmlSerializationCollectionFixupCallback

Delegado usado pela XmlSerializer classe para desserialização de tipos de dados XML codificados em SOAP que correspondem a 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 a partir de dados XML codificados em SOAP, não raiz.

XmlSerializationWriteCallback

Delegar que é usado pela XmlSerializer classe para serialização de tipos a partir de dados XML codificados em SOAP, não raiz.

Observações

A classe central no espaço de nomes é a XmlSerializer classe. Para usar esta classe, use o XmlSerializer construtor para criar uma instância da classe usando o tipo do objeto a serializar. Uma vez criado, XmlSerializer cria-se uma instância do objeto para serializar. Também deve criar um objeto para escrever o ficheiro num documento ou fluxo, como um Stream, TextWriter, ou XmlWriter. Pode então chamar o Serialize método para converter o objeto num documento XML.

Para desserializar um objeto a partir de um documento XML, crie-se um objeto adequado para ler o documento ou fluxo (novamente, um Stream, TextWriter, ou XmlWriter). Invocar o Deserialize método enquanto se conjura o 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 elemento XML, pode aplicar o XmlElementAttribute atributo ao membro. Ao aplicar o atributo, pode especificar detalhes como o nome real do elemento XML usando a ElementName propriedade. Para uma lista completa de todos os atributos, consulte a XmlSerializer visão geral da classe.