DataContractSerializer Classe
Definição
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.
Serializa e desserializa uma instância de um tipo num fluxo ou documento XML usando um contrato de dados fornecido. Esta classe não pode ser herdada.
public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer- Herança
Observações
Para mais informações sobre esta API, consulte Observações suplementares da API para o DataContractSerializer.
Construtores
| Name | Description |
|---|---|
| DataContractSerializer(Type, DataContractSerializerSettings) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo e definições especificados. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo objeto, o número máximo de elementos do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construções XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para serialização personalizada e uma alternativa para mapear |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de itens do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construções XML não padrão para preservar os dados de referência do objeto no grafo, e um substituto para serialização personalizada. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado, e uma coleção de tipos conhecidos que podem estar presentes no grafo de objetos. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de elementos do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construções XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para serialização personalizada, o elemento XML e o namespace que contém o conteúdo, e uma alternativa para mapear |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de itens do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construções XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para serialização personalizada, e o elemento e espaço de nomes XML que contêm o conteúdo. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica o elemento XML raiz e o namespace em dois parâmetros de string, bem como uma lista de tipos conhecidos que podem estar presentes no grafo de objetos. |
| DataContractSerializer(Type, String, String) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado usando o elemento raiz XML fornecido e o namespace. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo objeto, o número máximo de elementos do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construções XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para serialização personalizada, parâmetros XmlDictionaryString que especificam o elemento XML e o espaço de nomes que contém o conteúdo, e uma alternativa para mapear |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo objeto, o número máximo de itens do grafo a serializar, parâmetros para ignorar dados inesperados, se deve usar construtos XML não padrão para preservar dados de referência no grafo, um substituto para serialização personalizada, e parâmetros XmlDictionaryString que especificam o elemento XML e o espaço de nomes que contêm o conteúdo. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Este método também especifica o elemento XML raiz e o namespace em dois XmlDictionaryString parâmetros, bem como uma lista de tipos conhecidos que podem estar presentes no grafo objeto. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado usando o elemento raiz XML e o namespace especificados através dos parâmetros do tipo XmlDictionaryString. |
| DataContractSerializer(Type) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. |
Propriedades
| Name | Description |
|---|---|
| DataContractResolver |
Obtém o componente usado para mapear |
| DataContractSurrogate |
Obtém um tipo de substituição que pode prolongar o processo de serialização ou desserialização. |
| IgnoreExtensionDataObject |
Recebe um valor que especifica se deve ignorar dados fornecidos por uma extensão da classe quando a classe está a ser serializada ou desserializada. |
| KnownTypes |
Obtém uma coleção de tipos que podem estar presentes no grafo-objeto serializado usando esta instância do DataContractSerializer. |
| MaxItemsInObjectGraph |
Obtém o número máximo de itens num grafo objeto para serializar ou desserializar. |
| PreserveObjectReferences |
Obtém um valor que especifica se deve usar construções XML não padrão para preservar os dados de referência do objeto. |
| SerializeReadOnlyTypes |
Obtém um valor que especifica se os tipos de leitura somente são serializados. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsStartObject(XmlDictionaryReader) |
Determina se o XmlDictionaryReader está posicionado num objeto que pode ser desserializado. |
| IsStartObject(XmlReader) |
Determina se o XmlReader está posicionado num objeto que pode ser desserializado. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ReadObject(Stream) |
Lê o fluxo ou documento XML com um Stream e devolve o objeto desserializado. (Herdado de XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
Lê um documento XML ou fluxo de documentos e devolve o objeto deserializado. O método inclui um parâmetro para especificar se o nome do objeto está validado, e um resolvedor para mapear |
| ReadObject(XmlDictionaryReader, Boolean) |
Lê o fluxo XML com um XmlDictionaryReader e devolve o objeto desserializado, e também especifica se é feita uma verificação para verificar o nome do objeto antes de ler o seu valor. |
| ReadObject(XmlDictionaryReader) |
Lê o documento ou fluxo XML com um XmlDictionaryReader e devolve o objeto deserializado. (Herdado de XmlObjectSerializer) |
| ReadObject(XmlReader, Boolean) |
Lê o fluxo XML com um XmlReader e devolve o objeto desserializado, e também especifica se é feita uma verificação para verificar o nome do objeto antes de ler o seu valor. |
| ReadObject(XmlReader) |
Lê o fluxo XML com um XmlReader e devolve o objeto deserializado. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| WriteEndObject(XmlDictionaryWriter) |
Escreve o elemento XML de encerramento usando um XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Escreve o elemento XML de encerramento usando um XmlWriter. |
| WriteObject(Stream, Object) |
Escreve o conteúdo completo (início, conteúdo e fim) do objeto no documento ou fluxo XML com o especificado Stream. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
Escreve todos os dados do objeto (elemento XML inicial, conteúdo e elemento anexo) num documento ou fluxo XML usando o XmlDictionaryWriter especificado. O método inclui um resolvedor para mapear |
| WriteObject(XmlDictionaryWriter, Object) |
Escreve o conteúdo completo (início, conteúdo e fim) do objeto no documento ou fluxo XML com o especificado XmlDictionaryWriter. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlWriter, Object) |
Escreve todos os dados do objeto (elemento XML inicial, conteúdo e elemento de fecho) num documento ou fluxo XML com um XmlWriterelemento . |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Escreve o conteúdo XML usando um XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Escreve o conteúdo XML usando um XmlWriter. |
| WriteStartObject(XmlDictionaryWriter, Object) |
Escreve o elemento XML de abertura usando um XmlDictionaryWriterelemento . |
| WriteStartObject(XmlWriter, Object) |
Escreve o elemento XML de abertura usando um XmlWriterelemento . |
Métodos da Extensão
| Name | Description |
|---|---|
| GetSerializationSurrogateProvider(DataContractSerializer) |
Devolve o fornecedor de serialização substituta para este serializador. |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
Especifica um fornecedor de serialização substituta para isto DataContractSerializer. |
Aplica-se a
Segurança de Thread
Instâncias desta classe são thread safe, exceto quando a instância é usada com uma implementação do IDataContractSurrogate ou DataContractResolver.