DataContractSerializer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Serializa y deserializa una instancia de un tipo en un flujo XML o documento mediante un contrato de datos proporcionado. Esta clase no puede heredarse.
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- Herencia
Comentarios
Para obtener más información sobre esta API, consulte Comentarios complementarios de api para DataContractSerializer.
Constructores
| Nombre | Description |
|---|---|
| DataContractSerializer(Type, DataContractSerializerSettings) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo y la configuración especificados. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, los parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y una alternativa para las declaraciones de asignación |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo y un suplente para la serialización personalizada. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado y una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, el elemento XML y el espacio de nombres que contiene el contenido, y una alternativa para las declaraciones de asignación |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y el elemento XML y el espacio de nombres que contienen el contenido. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos parámetros de cadena, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractSerializer(Type, String, String) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz y el espacio de nombres XML proporcionados. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contiene el contenido, y una alternativa para las declaraciones de asignación |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contienen el contenido. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos XmlDictionaryString parámetros, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz XML y el espacio de nombres especificados a través de los parámetros de tipo XmlDictionaryString. |
| DataContractSerializer(Type) |
Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. |
Propiedades
| Nombre | Description |
|---|---|
| DataContractResolver |
Obtiene el componente usado para asignar dinámicamente |
| DataContractSurrogate |
Obtiene un tipo suplente que puede extender el proceso de serialización o deserialización. |
| IgnoreExtensionDataObject |
Obtiene un valor que especifica si se omiten los datos proporcionados por una extensión de la clase cuando la clase se serializa o deserializa. |
| KnownTypes |
Obtiene una colección de tipos que pueden estar presentes en el gráfico de objetos serializado mediante esta instancia de DataContractSerializer. |
| MaxItemsInObjectGraph |
Obtiene el número máximo de elementos de un gráfico de objetos para serializar o deserializar. |
| PreserveObjectReferences |
Obtiene un valor que especifica si se deben usar construcciones XML no estándar para conservar los datos de referencia de objetos. |
| SerializeReadOnlyTypes |
Obtiene un valor que especifica si se serializan los tipos de solo lectura. |
Métodos
| Nombre | Description |
|---|---|
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa 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 está situado en un objeto que se puede deserializar. |
| IsStartObject(XmlReader) |
Determina si XmlReader está situado en un objeto que se puede deserializar. |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ReadObject(Stream) |
Lee la secuencia XML o el documento con y Stream devuelve el objeto deserializado. (Heredado de XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
Lee un documento XML o una secuencia de documentos y devuelve el objeto deserializado. El método incluye un parámetro para especificar si se valida el nombre del objeto y un solucionador para las declaraciones de asignación |
| 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 del objeto antes de leer su valor. |
| ReadObject(XmlDictionaryReader) |
Lee el documento o secuencia XML con y XmlDictionaryReader devuelve el objeto deserializado. (Heredado de XmlObjectSerializer) |
| 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 del objeto antes de leer su valor. |
| ReadObject(XmlReader) |
Lee la secuencia XML con XmlReader y devuelve el objeto deserializado. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| WriteEndObject(XmlDictionaryWriter) |
Escribe el elemento XML de cierre mediante un XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Escribe el elemento XML de cierre mediante un XmlWriter. |
| WriteObject(Stream, Object) |
Escribe el contenido completo (inicio, contenido y fin) del objeto en el documento XML o secuencia con el especificado Stream. (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 xmlDictionaryWriter especificado. El método incluye una resolución para las declaraciones de asignación |
| WriteObject(XmlDictionaryWriter, Object) |
Escribe el contenido completo (inicio, contenido y fin) del objeto en el documento XML o secuencia con el especificado XmlDictionaryWriter. (Heredado de XmlObjectSerializer) |
| WriteObject(XmlWriter, Object) |
Escribe todos los datos del objeto (elemento XML inicial, contenido y elemento de cierre) en un documento XML o secuencia con un 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
| Nombre | Description |
|---|---|
| GetSerializationSurrogateProvider(DataContractSerializer) |
Devuelve el proveedor de serialización suplente para este serializador. |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
Especifica un proveedor de serialización suplente para este DataContractSerializer. |
Se aplica a
Seguridad para subprocesos
Las instancias de esta clase son seguras para subprocesos, excepto cuando la instancia se usa con una implementación de IDataContractSurrogate o DataContractResolver.