System.Xml.Serialization Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 < |
| 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.