DataContractJsonSerializer Clase

Definición

Serializa objetos a JavaScript Object Notation (JSON) y deserializa datos de JSON a objetos.Serializes objects to the JavaScript Object Notation (JSON) and deserializes JSON data to objects. Esta clase no puede heredarse.This class cannot be inherited.

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

Comentarios

Para la mayoría de los escenarios que implican la serialización en JSON y la deserialización de JSON, se recomiendan las herramientas del espacio de nombres System. Text. JSON.For most scenarios that involve serializing to JSON and deserializing from JSON, we recommend the tools in the System.Text.Json namespace.

Si su escenario requiere la clase DataContractJsonSerializer, puede usarla para serializar instancias de un tipo en un documento JSON y para deserializar un documento JSON en una instancia de un tipo.If your scenario requires the DataContractJsonSerializer class, you can use it to serialize instances of a type into a JSON document and to deserialize a JSON document into an instance of a type. Por ejemplo, puede crear un tipo denominado Person con propiedades que contienen datos esenciales, como un nombre y una dirección.For example, you can create a type named Person with properties that contain essential data, such as a name and address. A continuación puede crear y manipular una instancia de la clase Person y escribir todos sus valores de propiedad en un documento JSON para su recuperación posterior.You can then create and manipulate an instance of the Person class and write all of its property values in a JSON document for later retrieval. Este documento JSON se puede deserializar más tarde en la clase Person o en otra clase con un contrato de datos equivalente.This JSON document can later be deserialized into the Person class or another class with an equivalent data contract.

Si se produce un error durante la serialización de una respuesta saliente en el servidor o la operación de respuesta inicia una excepción por cualquier otro motivo, puede que no se devuelva al cliente como error.If an error occurs during the serialization of an outgoing reply on the server or the reply operation throws an exception for some other reason, it may not get returned to the client as a fault.

Constructores

DataContractJsonSerializer(Type)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo especificado.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo y configuración de serializador especificados.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type and serializer settings.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo especificado con una colección de tipos conocidos que pueden encontrarse en el gráfico de objetos.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type, with a collection of known types that may be present in the object graph.

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

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo especificado.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. 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 para serializar o deserializar, si omitir los datos inesperados o emitir información de tipo y un suplente para la serialización personalizada.This method also specifies a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, String)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto de un tipo especificado utilizando el elemento raíz de XML especificado por un parámetro.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto de un tipo especificado utilizando el elemento raíz de XML especificado por un parámetro, con una colección de tipos conocidos que pueden encontrarse en el gráfico de objetos.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter, with a collection of known types that may be present in the object graph.

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

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo especificado.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. Este método también especifica el nombre de raíz del elemento XML, una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico para serializar o deserializar, si omitir los datos inesperados o emitir información de tipo y un suplente para la serialización personalizada.This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

DataContractJsonSerializer(Type, XmlDictionaryString)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto de un tipo especificado utilizando el elemento raíz de XML especificado por un parámetro del tipo XmlDictionaryString.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto de un tipo especificado utilizando el elemento raíz de XML especificado por un parámetro del tipo XmlDictionaryString, con una colección de tipos conocidos que pueden encontrarse en el gráfico de objetos.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of a specified type using the XML root element specified by a parameter of type XmlDictionaryString, with a collection of known types that may be present in the object graph.

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

Inicializa una nueva instancia de la clase DataContractJsonSerializer para serializar o deserializar un objeto del tipo especificado.Initializes a new instance of the DataContractJsonSerializer class to serialize or deserialize an object of the specified type. Este método también especifica el nombre de raíz del elemento XML, una lista de tipos conocidos que pueden encontrarse en el gráfico de objetos, el número máximo de elementos de gráfico para serializar o deserializar, si omitir los datos inesperados o emitir información de tipo y un suplente para la serialización personalizada.This method also specifies the root name of the XML element, a list of known types that may be present in the object graph, the maximum number of graph items to serialize or deserialize, whether to ignore unexpected data or emit type information, and a surrogate for custom serialization.

Propiedades

DataContractSurrogate

Obtiene un tipo suplente que está activo actualmente para una instancia IDataContractSurrogate determinada.Gets a surrogate type that is currently active for a given IDataContractSurrogate instance. Los suplentes pueden extender el proceso de serialización o de deserialización.Surrogates can extend the serialization or deserialization process.

DateTimeFormat

Obtiene el formato de los elementos de tipo fecha y hora en un gráfico de objetos.Gets the format of the date and time type items in object graph.

EmitTypeInformation

Obtiene o establece la configuración del serializador JSON de contrato de datos para emitir información de tipo.Gets or sets the data contract JSON serializer settings to emit type information.

IgnoreExtensionDataObject

Obtiene un valor que especifica si los datos desconocidos se omiten en la deserialización y si la interfaz IExtensibleDataObject se omite en la serialización.Gets a value that specifies whether unknown data is ignored on deserialization and whether the IExtensibleDataObject interface is ignored on serialization.

KnownTypes

Obtiene una colección de tipos que se pueden encontrarse en el gráfico de objetos serializado utilizando esta instancia de DataContractJsonSerializer.Gets a collection of types that may be present in the object graph serialized using this instance of the DataContractJsonSerializer.

MaxItemsInObjectGraph

Obtiene el número máximo de elementos en un gráfico de objetos que el serializador serializa o deserializa en una llamada de lectura o de escritura.Gets the maximum number of items in an object graph that the serializer serializes or deserializes in one read or write call.

SerializeReadOnlyTypes

Obtiene o establece un valor que especifica si se van a serializar tipos de solo lectura.Gets or sets a value that specifies whether to serialize read only types.

UseSimpleDictionaryFormat

Obtiene un valor que especifica si se va a usar un formato de diccionario simple.Gets a value that specifies whether to use a simple dictionary format.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(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.Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that represents an object the serializer can deserialize from.

IsStartObject(XmlReader)

Determina si XmlReader se coloca en un objeto que se puede deserializar.Determines whether the XmlReader is positioned on an object that can be deserialized.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ReadObject(Stream)

Lee una secuencia del documento en el formato JSON (JavaScript Object Notation) y devuelve el objeto deserializado.Reads a document stream in the JSON (JavaScript Object Notation) format and returns the deserialized object.

ReadObject(XmlDictionaryReader)

Lee el documento XML asignado de JSON (JavaScript Object Notation) con XmlDictionaryReader y devuelve el objeto deserializado.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlDictionaryReader and returns the deserialized object.

ReadObject(XmlDictionaryReader, Boolean)

Lee el documento XML asignado de JSON con XmlDictionaryReader y devuelve el objeto deserializado; también le permite especificar si el serializador debería comprobar que está colocado sobre un elemento adecuado antes de intentar deserializar.Reads the XML document mapped from JSON with an XmlDictionaryReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ReadObject(XmlReader)

Lee el documento XML asignado de JSON (JavaScript Object Notation) con XmlReader y devuelve el objeto deserializado.Reads the XML document mapped from JSON (JavaScript Object Notation) with an XmlReader and returns the deserialized object.

ReadObject(XmlReader, Boolean)

Lee un documento XML asignado de JSON con XmlReader y devuelve el objeto deserializado; también le permite especificar si el serializador debería comprobar que está colocado sobre un elemento adecuado antes de intentar deserializar.Reads an XML document mapped from JSON with an XmlReader and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
WriteEndObject(XmlDictionaryWriter)

Escribe el elemento XML de cierre en un documento XML, que puede estar asignado a JavaScript Object Notation (JSON), mediante XmlDictionaryWriter.Writes the closing XML element to an XML document, using an XmlDictionaryWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteEndObject(XmlWriter)

Escribe el elemento XML de cierre en un documento XML, que puede estar asignado a JavaScript Object Notation (JSON), mediante XmlWriter.Writes the closing XML element to an XML document, using an XmlWriter, which can be mapped to JavaScript Object Notation (JSON).

WriteObject(Stream, Object)

Serializa un objeto especificado a datos JavaScript Object Notation (JSON) y escribe el JSON resultante en una secuencia.Serializes a specified object to JavaScript Object Notation (JSON) data and writes the resulting JSON to a stream.

WriteObject(XmlDictionaryWriter, Object)

Serializa a XML un objeto que puede estar asignado a JavaScript Object Notation (JSON).Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Escribe todos los datos de objeto (incluido el elemento XML inicial, el contenido y el elemento de cierre) con XmlDictionaryWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serializa a XML un objeto que puede estar asignado a JavaScript Object Notation (JSON).Serializes an object to XML that may be mapped to JavaScript Object Notation (JSON). Escribe todos los datos de objeto (incluido el elemento XML inicial, el contenido y el elemento de cierre) con XmlWriter.Writes all the object data, including the starting XML element, content, and closing element, with an XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Escribe el contenido de XML que puede asignarse a JavaScript Object Notation (JSON) mediante XmlDictionaryWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Escribe el contenido de XML que puede asignarse a JavaScript Object Notation (JSON) mediante XmlWriter.Writes the XML content that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Escribe el elemento XML de apertura para serializar un objeto a XML que puede asignarse a JavaScript Object Notation (JSON) utilizando XmlDictionaryWriter.Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Escribe el elemento XML de apertura para serializar un objeto a XML que puede asignarse a JavaScript Object Notation (JSON) utilizando XmlWriter.Writes the opening XML element for serializing an object to XML that can be mapped to JavaScript Object Notation (JSON) using an XmlWriter.

Se aplica a