JsonSerializer.Deserialize Método

Referencia

Definición

Espacio de nombres:: System.Text.Json

Ensamblado:: System.Text.Json.dll

Paquete:: System.Text.Json v8.0.5

Paquete:: System.Text.Json v9.0.0-rc.2.24473.5

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í.

Sobrecargas

Deserialize(Stream, JsonTypeInfo)	Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`. La secuencia se leerá hasta la finalización.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en un `returnType`.
Deserialize(JsonNode, Type, JsonSerializerContext)	Convierte el JsonNode que representa un único valor JSON en un `returnType`.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Convierte el JsonNode que representa un único valor JSON en un `returnType`.
Deserialize(JsonElement, Type, JsonSerializerContext)	Convierte el JsonElement que representa un único valor JSON en un `returnType`.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Convierte el JsonElement que representa un único valor JSON en un `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Convierte el JsonDocument que representa un único valor JSON en un `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Convierte el JsonDocument que representa un único valor JSON en un `returnType`.
Deserialize(String, Type, JsonSerializerContext)	Analiza el texto que representa un único valor JSON en un `returnType`.
Deserialize(String, Type, JsonSerializerOptions)	Analiza el texto que representa un único valor JSON en una instancia de un tipo especificado.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Analiza el texto que representa un único valor JSON en un `returnType`.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Analiza el texto que representa un único valor JSON en una instancia de un tipo especificado.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado y lo convierte en una instancia de un tipo especificado.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado.
Deserialize(Stream, Type, JsonSerializerContext)	Lee el texto codificado UTF-8 que representa un único valor JSON en un `returnType`. La secuencia se leerá hasta la finalización.
Deserialize(Stream, Type, JsonSerializerOptions)	Lee el texto codificado UTF-8 que representa un único valor JSON en un `returnType`. La secuencia se leerá hasta la finalización.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en una instancia especificada por el `jsonTypeInfo`.
Deserialize(JsonNode, JsonTypeInfo)	Convierte el JsonNode que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize(JsonElement, JsonTypeInfo)	Convierte el JsonElement que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize(JsonDocument, JsonTypeInfo)	Convierte el JsonDocument que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize(String, JsonTypeInfo)	Analiza el texto que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analiza el texto que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analiza el texto codificado UTF-8 que representa un único valor JSON en un `returnType`.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el `jsonTypeInfo`.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Convierte el JsonElement que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Convierte el JsonElement que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en un `TValue`.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Convierte el JsonNode que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en una instancia del tipo especificado por un parámetro de tipo genérico.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Convierte el JsonDocument que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Convierte el JsonNode que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Convierte el JsonDocument que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analiza el texto que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(String, JsonSerializerOptions)	Analiza el texto que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analiza el texto que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Analiza el texto codificado UTF-8 que representa un único valor JSON en un `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Lee el texto codificado UTF-8 que representa un único valor JSON en un `TValue`. La secuencia se leerá hasta la finalización.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Lee el texto codificado UTF-8 que representa un único valor JSON en un `TValue`. La secuencia se leerá hasta la finalización.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analiza el texto que representa un único valor JSON en un `TValue`.

Deserialize(Stream, JsonTypeInfo)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el jsonTypeInfo. La secuencia se leerá hasta la finalización.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

utf8Json: Stream

Datos JSON que se van a analizar.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

utf8Json o jsonTypeInfo es null.

JsonException

El JSON no es válido o hay datos restantes en stream.

Se aplica a

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en un returnType.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

reader: Utf8JsonReader

Lector que se va a leer.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType o context es null.

JsonException

El json no es válido, returnType no es compatible con el JSON o no se pudo leer un valor del lector.

ArgumentException

reader usa opciones no admitidas.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) en el context proporcionado no devolvió un JsonTypeInfo compatible para returnType.

Comentarios

Si la propiedad TokenType de reader es PropertyName o None, el lector se avanzada mediante una llamada a Read() para determinar el inicio del valor.

Tras la finalización de este método, reader se coloca en el token final del valor JSON. Si se produce una excepción, el lector se restablece al estado en el que se encontraba cuando se llamó al método .

Este método realiza una copia de los datos en los que el lector ha actuado, por lo que no hay ningún requisito de llamador para mantener la integridad de los datos más allá del retorno de este método.

El JsonReaderOptions usado para crear la instancia del Utf8JsonReader tiene prioridad sobre el JsonSerializerOptions cuando entran en conflicto. Por lo tanto, AllowTrailingCommas, MaxDepthy CommentHandling se usan al leer.

Se aplica a

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el JsonNode que representa un único valor JSON en un returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

node: JsonNode

El JsonNode que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

-o-

context es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) del context proporcionado devuelve null para que el tipo se convierta.

Se aplica a

Deserialize(JsonNode, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el JsonNode que representa un único valor JSON en un returnType.

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

node: JsonNode

El JsonNode que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

JsonException

returnType no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Se aplica a

Deserialize(JsonElement, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el JsonElement que representa un único valor JSON en un returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

element: JsonElement

El JsonElement que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

-o-

context es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) del context proporcionado devuelve null para que el tipo se convierta.

Se aplica a

Deserialize(JsonElement, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el JsonElement que representa un único valor JSON en un returnType.

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

element: JsonElement

El JsonElement que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

JsonException

returnType no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Se aplica a

Deserialize(JsonDocument, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el JsonDocument que representa un único valor JSON en un returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

document: JsonDocument

El JsonDocument que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

document es null.

-o-

returnType es null.

-o-

context es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) del context proporcionado devuelve null para que el tipo se convierta.

Se aplica a

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el JsonDocument que representa un único valor JSON en un returnType.

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

document: JsonDocument

El JsonDocument que se va a convertir.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

document o returnType es null.

JsonException

returnType no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Se aplica a

Deserialize(String, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en un returnType.

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

json: String

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

json o returnType es null.

-o-

context es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) del context proporcionado devuelve null para que el tipo se convierta.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize(String, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia de un tipo especificado.

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

json: String

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

json o returnType es null.

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en un returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

Parámetros

json: ReadOnlySpan<Char>

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

json o returnType es null.

-o-

context es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) del context proporcionado devuelve null para que el tipo se convierta.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia de un tipo especificado.

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

json: ReadOnlySpan<Char>

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en el intervalo más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Comentarios

El uso de un intervalo UTF-16 no es tan eficaz como usar los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado y lo convierte en una instancia de un tipo especificado.

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

reader: Utf8JsonReader

Lector del que se va a leer el código JSON.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento del serializador durante la lectura.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

No se pudo leer un valor del lector.

ArgumentException

reader usa opciones no admitidas.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Comentarios

Si la propiedad TokenType de reader es JsonTokenType.PropertyName o JsonTokenType.None, el lector se avanzada mediante una llamada a Utf8JsonReader.Read() para determinar el inicio del valor.

Tras la finalización de este método, reader se colocará en el token final en el valor JSON. Si se produce una excepción, el lector se restablece al estado en el que se encontraba cuando se llamó al método .

El JsonReaderOptions usado para crear la instancia del Utf8JsonReader tiene prioridad sobre el JsonSerializerOptions cuando entran en conflicto. Por lo tanto, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthy JsonReaderOptions.CommentHandling se usan al leer.

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado.

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

JsonException

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

Hay datos restantes en el intervalo más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Comentarios

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize(Stream, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lee el texto codificado UTF-8 que representa un único valor JSON en un returnType. La secuencia se leerá hasta la finalización.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object

Parámetros

utf8Json: Stream

Datos JSON que se van a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

utf8Json, returnTypeo context es null.

JsonException

El json no es válido, el returnType no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) en el context proporcionado no devolvió un JsonTypeInfo compatible para returnType.

Se aplica a

Deserialize(Stream, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lee el texto codificado UTF-8 que representa un único valor JSON en un returnType. La secuencia se leerá hasta la finalización.

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parámetros

utf8Json: Stream

Datos JSON que se van a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante la lectura.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

utf8Json o returnType es null.

JsonException

El json no es válido, el returnType no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

Se aplica a

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en una instancia especificada por el jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

reader: Utf8JsonReader

Lector que se va a leer.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

JsonException

El json no es válido, jsonTypeInfo no es compatible con el JSON o no se pudo leer un valor del lector.

ArgumentException

reader usa opciones no admitidas.

Comentarios

Si la propiedad TokenType de reader es PropertyName o None, el lector se avanzada mediante una llamada a Read() para determinar el inicio del valor.

Se aplica a

Deserialize(JsonNode, JsonTypeInfo)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el JsonNode que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

node: JsonNode

El JsonNode que se va a convertir.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

jsonTypeInfo es null.

Se aplica a

Deserialize(JsonElement, JsonTypeInfo)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el JsonElement que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

element: JsonElement

El JsonElement que se va a convertir.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

jsonTypeInfo es null.

Se aplica a

Deserialize(JsonDocument, JsonTypeInfo)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el JsonDocument que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

document: JsonDocument

El JsonDocument que se va a convertir.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

document es null.

-o-

jsonTypeInfo es null.

Se aplica a

Deserialize(String, JsonTypeInfo)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

json: String

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

json es null.

-o-

jsonTypeInfo es null.

JsonException

El JSON no es válido.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

json: ReadOnlySpan<Char>

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

ArgumentNullException

jsonTypeInfo es null.

JsonException

El JSON no es válido.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analiza el texto codificado UTF-8 que representa un único valor JSON en un returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

Parámetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON que se va a analizar.

returnType: Type

Tipo del objeto al que se va a convertir y devolver.

context: JsonSerializerContext

Proveedor de metadatos para tipos serializables.

Devoluciones

Object

Representación returnType del valor JSON.

Excepciones

ArgumentNullException

returnType es null.

JsonException

El JSON no es válido, returnType no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

InvalidOperationException

El método GetTypeInfo(Type) en el context proporcionado no devolvió un JsonTypeInfo compatible para returnType.

Se aplica a

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object

Parámetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo

Metadatos sobre el tipo que se va a convertir.

Devoluciones

Object

Representación jsonTypeInfo del valor JSON.

Excepciones

JsonException

El JSON no es válido o hay datos restantes en el búfer.

Se aplica a

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el JsonElement que representa un único valor JSON en un TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

element: JsonElement

El JsonElement que se va a convertir.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el JsonElement que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

element: JsonElement

El JsonElement que se va a convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

jsonTypeInfo es null.

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en un TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

reader: Utf8JsonReader

Lector que se va a leer.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

El json no es válido, TValue no es compatible con el JSON o no se pudo leer un valor del lector.

ArgumentException

reader usa opciones no admitidas.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

Si la propiedad TokenType de reader es PropertyName o None, el lector se avanzada mediante una llamada a Read() para determinar el inicio del valor.

Se aplica a

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el JsonNode que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

node: JsonNode

El JsonNode que se va a convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

jsonTypeInfo es null.

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos objetos o matrices) del lector proporcionado en una instancia del tipo especificado por un parámetro de tipo genérico.

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo de destino del valor JSON.

Parámetros

reader: Utf8JsonReader

Lector del que se va a leer el código JSON.

options: JsonSerializerOptions

Opciones para controlar el comportamiento del serializador durante la lectura.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

No se pudo leer un valor del lector.

ArgumentException

reader usa opciones no admitidas.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

Si la propiedad TokenType de reader es JsonTokenType.PropertyName o JsonTokenType.None, el lector se avanzada mediante una llamada a Utf8JsonReader.Read() para determinar el inicio del valor.

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el JsonDocument que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

document: JsonDocument

El JsonDocument que se va a convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

document es null.

-o-

jsonTypeInfo es null.

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el JsonNode que representa un único valor JSON en un TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

node: JsonNode

El JsonNode que se va a convertir.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el JsonDocument que representa un único valor JSON en un TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

document: JsonDocument

El JsonDocument que se va a convertir.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

document es null.

JsonException

TValue no es compatible con json.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

json: ReadOnlySpan<Char>

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

json es null.

-o-

jsonTypeInfo es null.

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize<TValue>(String, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo de destino del valor JSON.

Parámetros

json: String

Texto JSON que se va a analizar.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

json es null.

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

json: ReadOnlySpan<Char>

Texto JSON que se va a analizar.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en el intervalo más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

El uso de un intervalo UTF-16 no es tan eficaz como usar los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analiza el texto codificado UTF-8 que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

El JSON no es válido, TValue no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analiza el texto codificado UTF-8 que representa un único valor JSON en una instancia del tipo especificado por un parámetro de tipo genérico.

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo de destino del texto codificado UTF-8.

Parámetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON que se va a analizar.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante el análisis.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en el intervalo más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

Para obtener más información, consulte Cómo serializar y deserializar JSON.

Se aplica a

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lee el texto codificado UTF-8 que representa un único valor JSON en un TValue. La secuencia se leerá hasta la finalización.

public:
generic <typename TValue>
 static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

utf8Json: Stream

Datos JSON que se van a analizar.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

utf8Json o jsonTypeInfo es null.

JsonException

El JSON no es válido, TValue no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(Stream, JsonSerializerOptions)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lee el texto codificado UTF-8 que representa un único valor JSON en un TValue. La secuencia se leerá hasta la finalización.

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

utf8Json: Stream

Datos JSON que se van a analizar.

options: JsonSerializerOptions

Opciones para controlar el comportamiento durante la lectura.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

utf8Json es null.

JsonException

El JSON no es válido, TValue no es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Se aplica a

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analiza el texto que representa un único valor JSON en un TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parámetros de tipo

TValue

Tipo en el que se va a deserializar el valor JSON.

Parámetros

json: String

Texto JSON que se va a analizar.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadatos sobre el tipo que se va a convertir.

Devoluciones

TValue

Representación TValue del valor JSON.

Excepciones

ArgumentNullException

json es null.

-o-

jsonTypeInfo es null.

JsonException

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

Hay datos restantes en la cadena más allá de un único valor JSON.

NotSupportedException

No hay JsonConverter compatibles para TValue ni sus miembros serializables.

Comentarios

El uso de un String no es tan eficaz como el uso de los métodos UTF-8, ya que la implementación usa de forma nativa UTF-8.

Se aplica a

Compartir a través de

JsonSerializer.Deserialize Método

Definición

Sobrecargas

Deserialize(Stream, JsonTypeInfo)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(JsonNode, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(JsonNode, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(JsonElement, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(JsonElement, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(JsonDocument, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Se aplica a

Deserialize(String, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(String, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Parámetros

Devoluciones

Excepciones

Comentarios