DataContractJsonSerializer 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 los objetos en la notación de objetos JavaScript (JSON) y deserializa los datos JSON en objetos. Esta clase no puede heredarse.
public ref class DataContractJsonSerializer sealed
public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
type DataContractJsonSerializer = class
inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
- Herencia
-
DataContractJsonSerializer
- Herencia
Comentarios
Para la mayoría de los escenarios que implican la serialización en JSON y la deserialización de JSON, se recomiendan las API en el espacio de nombres System.Text.Json.
Si el escenario requiere la DataContractJsonSerializer clase , puede usarla para serializar instancias de un tipo en un documento JSON y para deserializar un documento JSON en una instancia de un tipo. Por ejemplo, puede crear un tipo denominado Person con propiedades que contengan datos esenciales, como un nombre y una dirección. A continuación, puede crear y manipular una instancia de la Person clase y escribir todos sus valores de propiedad en un documento JSON para su posterior recuperación. Este documento JSON se puede deserializar posteriormente en la Person clase u otra clase con un contrato de datos equivalente.
Si se produce un error durante la serialización de una respuesta saliente en el servidor o la operación de respuesta produce una excepción por algún otro motivo, es posible que no se devuelva al cliente como un error.
Constructores
| Nombre | Description |
|---|---|
| DataContractJsonSerializer(Type, DataContractJsonSerializerSettings) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto de la configuración de tipo y serializador especificados. |
| DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
Inicializa una nueva instancia de la DataContractJsonSerializer 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 o deserializar, si se omitirán datos inesperados o emitir información de tipos, y un suplente para la serialización personalizada. |
| DataContractJsonSerializer(Type, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto del tipo especificado, con una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el nombre raíz del elemento XML, 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 o deserializar, si se omiten datos inesperados o emiten información de tipos, y un suplente para la serialización personalizada. |
| DataContractJsonSerializer(Type, String, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto de un tipo especificado mediante el elemento raíz XML especificado por un parámetro, con una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractJsonSerializer(Type, String) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto de un tipo especificado mediante el elemento raíz XML especificado por un parámetro. |
| DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el nombre raíz del elemento XML, 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 o deserializar, si se omiten datos inesperados o emiten información de tipos, y un suplente para la serialización personalizada. |
| DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto de un tipo especificado mediante el elemento raíz XML especificado por un parámetro de tipo XmlDictionaryString, con una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos. |
| DataContractJsonSerializer(Type, XmlDictionaryString) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto de un tipo especificado mediante el elemento raíz XML especificado por un parámetro de tipo XmlDictionaryString. |
| DataContractJsonSerializer(Type) |
Inicializa una nueva instancia de la DataContractJsonSerializer clase para serializar o deserializar un objeto del tipo especificado. |
Propiedades
| Nombre | Description |
|---|---|
| DataContractSurrogate |
Obtiene un tipo suplente que está activo actualmente para una instancia determinada IDataContractSurrogate . Los suplentes pueden ampliar el proceso de serialización o deserialización. |
| DateTimeFormat |
Obtiene el formato de los elementos de tipo de fecha y hora en el gráfico de objetos. |
| EmitTypeInformation |
Obtiene o establece la configuración del serializador JSON del contrato de datos para emitir información de tipo. |
| IgnoreExtensionDataObject |
Obtiene un valor que especifica si los datos desconocidos se omiten en la deserialización y si la interfaz se omite en la IExtensibleDataObject serialización. |
| KnownTypes |
Obtiene una colección de tipos que pueden estar presentes en el gráfico de objetos serializado mediante esta instancia de DataContractJsonSerializer. |
| MaxItemsInObjectGraph |
Obtiene el número máximo de elementos de un gráfico de objetos que el serializador serializa o deserializa en una llamada de lectura o escritura. |
| SerializeReadOnlyTypes |
Obtiene o establece un valor que especifica si se van a serializar tipos de solo lectura. |
| UseSimpleDictionaryFormat |
Obtiene un valor que especifica si se va a usar un formato de diccionario simple. |
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) |
Obtiene un valor que especifica si XmlDictionaryReader se coloca sobre un elemento XML que representa un objeto del que el serializador 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 un flujo de documento en el formato JSON (notación de objetos JavaScript) y devuelve el objeto deserializado. |
| ReadObject(XmlDictionaryReader, Boolean) |
Lee el documento XML asignado desde JSON con XmlDictionaryReader y devuelve el objeto deserializado; también permite especificar si el serializador debe comprobar que está colocado en un elemento adecuado antes de intentar deserializar. |
| ReadObject(XmlDictionaryReader) |
Lee el documento XML asignado desde JSON (notación de objetos JavaScript) con XmlDictionaryReader y devuelve el objeto deserializado. |
| ReadObject(XmlReader, Boolean) |
Lee un documento XML asignado desde JSON con XmlReader y devuelve el objeto deserializado; también permite especificar si el serializador debe comprobar que está colocado en un elemento adecuado antes de intentar deserializar. |
| ReadObject(XmlReader) |
Lee el documento XML asignado desde JSON (notación de objetos JavaScript) 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 en un documento XML, mediante un XmlDictionaryWriter, que se puede asignar a notación de objetos JavaScript (JSON). |
| WriteEndObject(XmlWriter) |
Escribe el elemento XML de cierre en un documento XML, mediante un XmlWriter, que se puede asignar a notación de objetos JavaScript (JSON). |
| WriteObject(Stream, Object) |
Serializa un objeto especificado en datos de notación de objetos JavaScript (JSON) y escribe el JSON resultante en una secuencia. |
| WriteObject(XmlDictionaryWriter, Object) |
Serializa un objeto a XML que se puede asignar a notación de objetos JavaScript (JSON). Escribe todos los datos del objeto, incluido el elemento XML inicial, el contenido y el elemento de cierre, con un XmlDictionaryWriter. |
| WriteObject(XmlWriter, Object) |
Serializa un objeto a XML que se puede asignar a notación de objetos JavaScript (JSON). Escribe todos los datos del objeto, incluido el elemento XML inicial, el contenido y el elemento de cierre, con un XmlWriter. |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Escribe el contenido XML que se puede asignar a la notación de objetos JavaScript (JSON) mediante un XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Escribe el contenido XML que se puede asignar a la notación de objetos JavaScript (JSON) mediante un XmlWriter. |
| WriteStartObject(XmlDictionaryWriter, Object) |
Escribe el elemento XML de apertura para serializar un objeto en XML que se puede asignar a notación de objetos JavaScript (JSON) mediante .XmlDictionaryWriter |
| WriteStartObject(XmlWriter, Object) |
Escribe el elemento XML de apertura para serializar un objeto en XML que se puede asignar a notación de objetos JavaScript (JSON) mediante .XmlWriter |