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