Comparteix a través de


DataContractSerializer Clase

Definición

Serializa y deserializa una instancia de un tipo en un flujo o en un documento XML utilizando un contrato de datos proporcionado. Esta clase no puede heredarse.

public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer
Herencia
DataContractSerializer

Comentarios

Para más información sobre esta API, consulte Comentarios complementarios de api para DataContractSerializer.

Constructores

DataContractSerializer(Type)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado.

DataContractSerializer(Type, DataContractSerializerSettings)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo y configuración especificados.

DataContractSerializer(Type, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado y una colección de tipos conocidos que pueden encontrarse en el gráfico de objetos.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si utilizar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, y un suplente para la serialización personalizada.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, un suplente para la serialización personalizada, y una alternativa para asignar las declaraciones xsi:type en tiempo de ejecución.

DataContractSerializer(Type, String, String)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado utilizando el elemento raíz y el espacio de nombres XML proporcionados.

DataContractSerializer(Type, String, String, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento raíz y el espacio de nombres XML en dos parámetros de cadena así como una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si utilizar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, un suplente para la serialización personalizada, así como el elemento y el espacio de nombres XML que incluyen el contenido.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, un suplente para la serialización personalizada, el elemento XML y el espacio de nombres que incluye el contenido y una alternativa para asignar las declaraciones xsi:type en tiempo de ejecución.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado utilizando el elemento raíz XML y el espacio de nombres especificados mediante los parámetros del tipo XmlDictionaryString.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento raíz y el espacio de nombres XML en dos parámetros XmlDictionaryString así como una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si utilizar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, un suplente para la serialización personalizada y parámetros de XmlDictionaryString que especifican el elemento y el espacio de nombres XML que incluyen el contenido.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Inicializa una nueva instancia de la clase DataContractSerializer para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico a serializar, parámetros para omitir los datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia a objeto en el gráfico, un suplente para la serialización personalizada, parámetros de XmlDictionaryString que especifican el elemento XML y el espacio de nombres que incluye el contenido y una alternativa para asignar las declaraciones xsi:type en tiempo de ejecución.

Propiedades

DataContractResolver

Obtiene el componente utilizado para asignar dinámicamente las declaraciones xsi:type a los tipos de contrato conocidos.

DataContractSurrogate

Obtiene un tipo de suplente que puede extender el proceso de serialización o deserialización.

IgnoreExtensionDataObject

Obtiene un valor que especifica si omitir datos proporcionados por una extensión de la clase cuando la clase se serializa o deserializa.

KnownTypes

Obtiene una colección de tipos que se pueden encontrarse en el gráfico de objetos serializado utilizando esta instancia de DataContractSerializer.

MaxItemsInObjectGraph

Obtiene el número máximo de elementos de un gráfico de objetos que se van a serializar o deserializar.

PreserveObjectReferences

Obtiene un valor que especifica si utilizar construcciones XML no estándar para conservar los datos de referencia al objeto.

SerializeReadOnlyTypes

Obtiene un valor que especifica si los tipos de solo lectura se serializan.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsStartObject(XmlDictionaryReader)

Determina si XmlDictionaryReader se coloca en un objeto que se puede deserializar.

IsStartObject(XmlReader)

Determina si XmlReader se coloca en un objeto que se puede deserializar.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ReadObject(Stream)

Lee la secuencia o el documento XML con Stream y devuelve el objeto deserializado.

(Heredado de XmlObjectSerializer)
ReadObject(XmlDictionaryReader)

Lee el documento o la secuencia XML con XmlDictionaryReader y devuelve el objeto deserializado.

(Heredado de XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)

Lee la secuencia XML con XmlDictionaryReader y devuelve el objeto deserializado y también especifica si se realiza una comprobación para comprobar el nombre de objeto antes de leer su valor.

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

Lee un documento o secuencia del documento XML y devuelve el objeto deserializado. El método incluye un parámetro para especificar si se comprueba el nombre de objeto se valida y una resolución para asignar las declaraciones xsi:type en tiempo de ejecución.

ReadObject(XmlReader)

Lee el flujo XML con XmlReader y devuelve el objeto deserializado.

ReadObject(XmlReader, Boolean)

Lee la secuencia XML con XmlReader y devuelve el objeto deserializado y también especifica si se realiza una comprobación para comprobar el nombre de objeto antes de leer su valor.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
WriteEndObject(XmlDictionaryWriter)

Escribe el elemento XML de cierre mediante XmlDictionaryWriter.

WriteEndObject(XmlWriter)

Escribe el elemento XML de cierre mediante XmlWriter.

WriteObject(Stream, Object)

Escribe todo el contenido (inicio, contenido y fin) del objeto en el documento o la secuencia XML con el Stream especificado.

(Heredado de XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)

Escribe todo el contenido (inicio, contenido y fin) del objeto en el documento o la secuencia XML con el XmlDictionaryWriter especificado.

(Heredado de XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)

Escribe todos los datos del objeto (elemento XML inicial, contenido y elemento envolvente) en un documento XML o secuencia mediante el xmlDictionaryWriter especificado. El método incluye una resolución para asignar las declaraciones xsi:type en tiempo de ejecución.

WriteObject(XmlWriter, Object)

Escribe todos los datos de objeto (elemento XML inicial, contenido y elemento de cierre) en un documento o secuencia XML con XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Escribe el contenido XML mediante XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Escribe el contenido XML mediante XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Escribe el elemento XML de apertura mediante XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Escribe el elemento XML de apertura mediante XmlWriter.

Métodos de extensión

GetSerializationSurrogateProvider(DataContractSerializer)

Devuelve el proveedor de serialización suplente para este serializador.

SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)

Especifica un proveedor de serialización suplente para este elemento DataContractSerializer.

Se aplica a

Seguridad para subprocesos

Las instancias de esta clase son seguras para subprocesos, excepto cuando se usa la instancia con una implementación de IDataContractSurrogate o DataContractResolver.

Consulte también