JsonSerializer.Deserialize Método

Referencia

Definición

Espacio de nombres:: System.Text.Json

Ensamblado:: System.Text.Json.dll

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

El 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 desde el lector.

ArgumentException

reader usa opciones no compatibles.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

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

Comentarios

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

Tras la finalización de este método, reader se coloca en el token final en el valor JSON. Si se produce una excepción, el lector se restablece al estado en que estaba 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 del autor de la llamada para mantener la integridad de los datos más allá del retorno de este método.

que JsonReaderOptions se usa para crear la instancia de tiene Utf8JsonReader prioridad sobre el JsonSerializerOptions momento en que entran en conflicto. Por lo tanto, AllowTrailingCommas MaxDepth, y CommentHandling se usan durante la lectura.

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 desde el que se va a leer el 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 bien

returnType no es compatible con el JSON.

o bien

No se pudo leer un valor del lector.

ArgumentException

reader usa opciones no compatibles.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

Comentarios

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

Al finalizar este método, reader se colocará en el token final del valor JSON. Si se produce una excepción, el lector se restablece al estado en que estaba cuando se llamó al método .

que JsonReaderOptions se usa para crear la instancia de tiene Utf8JsonReader prioridad sobre el JsonSerializerOptions momento en que entran en conflicto. Por lo tanto, JsonReaderOptions.AllowTrailingCommas JsonReaderOptions.MaxDepth, y JsonReaderOptions.CommentHandling se usan durante la lectura.

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

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 objeto que representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o 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 objeto que representa un único valor JSON en .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

Valor 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 bien

context es null.

JsonException

El JSON no es válido.

o bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método del objeto proporcionado context devuelve null para el tipo que se va a convertir.

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 objeto que representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o 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 objeto que representa un único valor JSON en .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

Valor 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 bien

returnType es null.

O bien

context es null.

JsonException

El JSON no es válido.

o bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método del objeto proporcionado context devuelve null para el tipo que se va a convertir.

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 objeto que representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o 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 .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 bien

context es null.

JsonException

El JSON no es válido.

o bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método del objeto proporcionado context devuelve null para el tipo que se va a convertir.

Comentarios

El uso de un String elemento 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 bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

Comentarios

El uso de un String elemento 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 más información, consulte Serialización y deserialización de 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 .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 bien

context es null.

JsonException

El JSON no es válido.

o bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método de los retornos proporcionados contextnull para el tipo que se va a convertir.

Comentarios

El uso de un String elemento 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 bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o 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(JsonNode, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el objeto que JsonNode representa un único valor JSON en .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

Valor 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 bien

context es null.

JsonException

El JSON no es válido.

o bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método de los retornos proporcionados contextnull para el tipo que se va a convertir.

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 con codificación 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 bien

returnType no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

Comentarios

Para más información, consulte Serialización y deserialización de JSON.

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 .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 ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método en el proporcionado context no devolvió una compatibilidad para returnTypeJsonTypeInfo .

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 .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(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 .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 bien

jsonTypeInfo es null.

JsonException

El JSON no es válido.

o bien

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

Comentarios

El uso de un String elemento 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(JsonDocument, JsonTypeInfo)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convierte el objeto que JsonDocument representa un único valor JSON en una instancia especificada por .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

Valor 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 bien

jsonTypeInfo es null.

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

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

Comentarios

El uso de un String elemento 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(JsonNode, JsonTypeInfo)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convierte el objeto que JsonNode representa un único valor JSON en una instancia especificada por .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

Valor 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(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 .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

El 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 desde el lector.

ArgumentException

reader usa opciones no compatibles.

Comentarios

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

Tras la finalización de este método, reader se colocará 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 ha actuado el lector, por lo que no hay ningún requisito del autor de la llamada para mantener la integridad de los datos más allá del retorno de este método.

JsonReaderOptions que se usa para crear la instancia de tiene Utf8JsonReader prioridad sobre cuando JsonSerializerOptions entran en conflicto. Por lo tanto, , AllowTrailingCommas MaxDepthy CommentHandling se usan durante la lectura.

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, no returnType es compatible con el JSON o hay datos restantes en stream.

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

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, returnType o context es null.

JsonException

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

NotSupportedException

No hay ningún JsonConverter compatible para returnType o sus miembros serializables.

InvalidOperationException

El GetTypeInfo(Type) método en el proporcionado context no devolvió una compatibilidad para returnTypeJsonTypeInfo .

Se aplica a

Deserialize(JsonElement, JsonTypeInfo)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el objeto que JsonElement representa un único valor JSON en una instancia especificada por .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

Valor 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<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lee un valor JSON (incluidos los objetos o matrices) del lector proporcionado en .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

El 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 desde el lector.

ArgumentException

reader usa opciones no compatibles.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

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

Tras la finalización de este método, reader se coloca 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 .

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 objeto que JsonDocument representa un único valor JSON en .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

Valor 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 bien

jsonTypeInfo es null.

JsonException

TValue no es compatible con el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o 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) desde el 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 desde el que se va a leer el 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 bien

TValue no es compatible con el JSON.

o bien

No se pudo leer un valor del lector.

ArgumentException

reader usa opciones no compatibles.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

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

JsonReaderOptions que se usa para crear la instancia de tiene Utf8JsonReader prioridad sobre cuando JsonSerializerOptions entran en conflicto. Por lo tanto, , JsonReaderOptions.AllowTrailingCommas JsonReaderOptions.MaxDepthy JsonReaderOptions.CommentHandling se usan durante la lectura.

Para más información, consulte Serialización y deserialización de JSON.

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 objeto que JsonNode representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o 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 objeto que JsonNode representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o 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 objeto que JsonElement representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Se aplica a

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convierte el objeto que JsonElement representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o 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 objeto que JsonDocument representa un único valor JSON en .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

Valor 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 el JSON.

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

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 bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para TValue o 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>(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 bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

El uso de un String elemento 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 más información, consulte Serialización y deserialización de JSON.

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

jsonTypeInfo es null.

JsonException

El JSON no es válido.

o bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

El uso de un String elemento 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>(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 .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 ningún JsonConverter compatible para TValue o 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 con codificación 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 bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

Para más información, consulte Serialización y deserialización de 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 .TValue El objeto Stream 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 ningún JsonConverter compatible para TValue o 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 .TValue El objeto Stream 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 ningún JsonConverter compatible para TValue o 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 .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 bien

jsonTypeInfo es null.

JsonException

El JSON no es válido.

o bien

TValue no es compatible con el JSON.

o bien

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

NotSupportedException

No hay ningún JsonConverter compatible para TValue o sus miembros serializables.

Comentarios

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

Se aplica a