JsonSerializer.Deserialize Método

Definición

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

Representación jsonTypeInfo del valor JSON.

Excepciones

utf8Json o jsonTypeInfo es null.

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

Representación returnType del valor JSON.

Excepciones

returnType o context es null.

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

reader usa opciones no admitidas.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

-o-

context es null.

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.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

returnType no es compatible con json.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

-o-

context es null.

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.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

returnType no es compatible con json.

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

Representación returnType del valor JSON.

Excepciones

document es null.

-o-

returnType es null.

-o-

context es null.

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.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

document o returnType es null.

returnType no es compatible con json.

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

Representación returnType del valor JSON.

Excepciones

json o returnType es null.

-o-

context es null.

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.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

json o returnType es null.

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.

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

Representación returnType del valor JSON.

Excepciones

json o returnType es null.

-o-

context es null.

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.

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

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.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

El JSON no es válido.

-o-

returnType no es compatible con json.

-o-

No se pudo leer un valor del lector.

reader usa opciones no admitidas.

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 .

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, 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
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

Representación returnType del valor JSON.

Excepciones

returnType es null.

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.

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

Representación returnType del valor JSON.

Excepciones

utf8Json, returnTypeo context es null.

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

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación returnType del valor JSON.

Excepciones

utf8Json o returnType es null.

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

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

Representación jsonTypeInfo del valor JSON.

Excepciones

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

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.

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 .

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, JsonTypeInfo)

Source:
JsonSerializer.Read.Node.cs
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 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

Representación jsonTypeInfo del valor JSON.

Excepciones

jsonTypeInfo es null.

Se aplica a

Deserialize(JsonElement, JsonTypeInfo)

Source:
JsonSerializer.Read.Element.cs
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 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

Representación jsonTypeInfo del valor JSON.

Excepciones

jsonTypeInfo es null.

Se aplica a

Deserialize(JsonDocument, JsonTypeInfo)

Source:
JsonSerializer.Read.Document.cs
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 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

Representación jsonTypeInfo del valor JSON.

Excepciones

document es null.

-o-

jsonTypeInfo es null.

Se aplica a

Deserialize(String, JsonTypeInfo)

Source:
JsonSerializer.Read.String.cs
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 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

Representación jsonTypeInfo del valor JSON.

Excepciones

json es null.

-o-

jsonTypeInfo es null.

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

Representación jsonTypeInfo del valor JSON.

Excepciones

jsonTypeInfo es null.

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

Representación returnType del valor JSON.

Excepciones

returnType es null.

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

No hay JsonConverter compatibles para returnType ni sus miembros serializables.

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

Representación jsonTypeInfo del valor JSON.

Excepciones

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

TValue no es compatible con json.

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

jsonTypeInfo es null.

TValue no es compatible con json.

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

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

reader usa opciones no admitidas.

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.

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

Source:
JsonSerializer.Read.Node.cs
Source:
JsonSerializer.Read.Node.cs
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

jsonTypeInfo es null.

TValue no es compatible con json.

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

El JSON no es válido.

-o-

TValue no es compatible con json.

-o-

No se pudo leer un valor del lector.

reader usa opciones no admitidas.

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.

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 .

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

Source:
JsonSerializer.Read.Document.cs
Source:
JsonSerializer.Read.Document.cs
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

document es null.

-o-

jsonTypeInfo es null.

TValue no es compatible con json.

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

TValue no es compatible con json.

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

document es null.

TValue no es compatible con json.

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

json es null.

-o-

jsonTypeInfo es null.

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.

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

json es null.

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.

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

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.

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

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

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

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.

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

utf8Json o jsonTypeInfo es null.

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

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

utf8Json es null.

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

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

json es null.

-o-

jsonTypeInfo es null.

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.

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