System.Xml.Serialization Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 < |
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.