JsonSerializer.Deserialize Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Text.Json

Assembly:: System.Text.Json.dll

Pacchetto:: System.Text.Json v8.0.3

Pacchetto:: System.Text.Json v9.0.0-preview.3.24172.9

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Deserialize(Stream, JsonTypeInfo)	Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da . Il flusso verrà letto al completamento.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un `returnType`oggetto .
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito e lo converte in un'istanza di un tipo specificato.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(JsonElement, Type, JsonSerializerContext)	Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(JsonElement, Type, JsonSerializerOptions)	Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(JsonDocument, Type, JsonSerializerContext)	Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(String, Type, JsonSerializerContext)	Analizza il testo che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(String, Type, JsonSerializerOptions)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Analizza il testo che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.
Deserialize(JsonNode, Type, JsonSerializerContext)	Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analizza il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `returnType`oggetto .
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analizza il testo codificato UTF-8 che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize(String, JsonTypeInfo)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize(JsonDocument, JsonTypeInfo)	Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize(JsonNode, JsonTypeInfo)	Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize(Utf8JsonReader, JsonTypeInfo)	Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un'istanza `jsonTypeInfo`specificata da .
Deserialize(Stream, Type, JsonSerializerOptions)	Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `returnType`oggetto . Il flusso verrà letto al completamento.
Deserialize(Stream, Type, JsonSerializerContext)	Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `returnType`oggetto . Il flusso verrà letto al completamento.
Deserialize(JsonElement, JsonTypeInfo)	Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un'istanza `jsonTypeInfo`specificata da .
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un `TValue`oggetto .
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Legge un valore JSON (inclusi oggetti o matrici) dal lettore specificato in un'istanza del tipo specificato da un parametro di tipo generico.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.
Deserialize<TValue>(String, JsonSerializerOptions)	Analizza il testo che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analizza il testo che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Analizza il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `TValue`oggetto .
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `TValue`oggetto . Il flusso verrà letto al completamento.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un `TValue`oggetto . Il flusso verrà letto al completamento.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analizza il testo che rappresenta un singolo valore JSON in un `TValue`oggetto .

Deserialize(Stream, JsonTypeInfo)

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da . Il flusso verrà letto al completamento.

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

Parametri

utf8Json: Stream

Dati JSON da analizzare.

jsonTypeInfo: JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

utf8Json o jsonTypeInfo è null.

JsonException

Il codice JSON non è valido oppure i dati rimanenti nel flusso.

Si applica a

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Legge un valore JSON (inclusi gli oggetti o le matrici) dal lettore fornito in un oggetto 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

Parametri

reader: Utf8JsonReader

Lettore per eseguire la lettura.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType o context è null.

JsonException

Il valore JSON non è valido, returnType non è compatibile con il valore JSON oppure il lettore non è riuscito a leggere un valore.

ArgumentException

reader usa opzioni non supportate.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Il GetTypeInfo(Type) metodo nell'oggetto fornito context non ha restituito un oggetto compatibile JsonTypeInfo per returnType.

Commenti

Se la TokenType proprietà di reader è PropertyName o None, il lettore verrà avanzato da una chiamata a Read() per determinare l'inizio del valore.

Al termine di questo metodo, reader viene posizionato al token finale nel valore JSON. Se viene generata un'eccezione, il lettore viene reimpostato sullo stato in cui si trovava quando è stato chiamato il metodo .

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Oggetto JsonReaderOptions utilizzato per creare l'istanza di ha Utf8JsonReader la precedenza sull'oggetto JsonSerializerOptions quando sono in conflitto. Di conseguenza, AllowTrailingCommas, MaxDepthe CommentHandling vengono usati durante la lettura.

Si applica a

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Legge un valore JSON (inclusi gli oggetti o le matrici) dal lettore fornito e lo converte in un'istanza di un tipo specificato.

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

Parametri

reader: Utf8JsonReader

Lettore da cui leggere il valore JSON.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento del serializzatore durante la lettura.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Il lettore non è riuscito a leggere un valore.

ArgumentException

reader usa opzioni non supportate.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Commenti

Se la TokenType proprietà di reader è JsonTokenType.PropertyName o JsonTokenType.None, il lettore verrà avanzato da una chiamata a Utf8JsonReader.Read() per determinare l'inizio del valore.

Al termine di questo metodo, reader il token finale verrà posizionato nel valore JSON. Se viene generata un'eccezione, il lettore viene reimpostato sullo stato in cui si trovava quando è stato chiamato il metodo .

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Oggetto JsonReaderOptions utilizzato per creare l'istanza di ha Utf8JsonReader la precedenza sull'oggetto JsonSerializerOptions quando sono in conflitto. Di conseguenza, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthe JsonReaderOptions.CommentHandling vengono usati durante la lettura.

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

Deserialize(JsonNode, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un oggetto 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

Parametri

node: JsonNode

Oggetto JsonNode da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

JsonException

returnType non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Si applica a

Deserialize(JsonElement, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un oggetto 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

Parametri

element: JsonElement

Oggetto JsonElement da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

-oppure-

context è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Si applica a

Deserialize(JsonElement, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un oggetto 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

Parametri

element: JsonElement

Oggetto JsonElement da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

JsonException

returnType non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Si applica a

Deserialize(JsonDocument, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un oggetto 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

Parametri

document: JsonDocument

Oggetto JsonDocument da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

document è null.

-oppure-

returnType è null.

-oppure-

context è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Si applica a

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un oggetto 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

Parametri

document: JsonDocument

Oggetto JsonDocument da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

document o returnType è null.

JsonException

returnType non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Si applica a

Deserialize(String, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un oggetto 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

Parametri

json: String

Testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

json o returnType è null.

-oppure-

context è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize(String, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.

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

Parametri

json: String

Il testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

json o returnType è null.

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un oggetto 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

Parametri

json: ReadOnlySpan<Char>

Testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

json o returnType è null.

-oppure-

context è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.

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

Parametri

json: ReadOnlySpan<Char>

Il testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nell'intervallo oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Commenti

L'uso di un intervallo UTF-16 non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize(JsonNode, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un oggetto 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

Parametri

node: JsonNode

Oggetto JsonNode da convertire.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

-oppure-

context è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Si applica a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato.

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

Parametri

utf8Json: ReadOnlySpan<Byte>

Il testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

JsonException

Valore JSON non valido.

-oppure-

returnType non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nell'intervallo oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un oggetto 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

Parametri

utf8Json: ReadOnlySpan<Byte>

Testo JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

returnType è null.

JsonException

Il codice JSON non è valido, returnType non è compatibile con il codice JSON o sono presenti dati rimanenti in Stream.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Il GetTypeInfo(Type) metodo nell'oggetto fornito context non ha restituito un oggetto compatibile JsonTypeInfo per returnType.

Si applica a

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata da 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

Parametri

utf8Json: ReadOnlySpan<Byte>

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

JsonException

Il codice JSON non è valido oppure sono presenti dati rimanenti nel buffer.

Si applica a

Deserialize(String, JsonTypeInfo)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da .

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

Parametri

json: String

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

json è null.

-oppure-

jsonTypeInfo è null.

JsonException

Valore JSON non valido.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize(JsonDocument, JsonTypeInfo)

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da .

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

Parametri

document: JsonDocument

Oggetto JsonDocument da convertire.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

document è null.

-oppure-

jsonTypeInfo è null.

Si applica a

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da .

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

Parametri

json: ReadOnlySpan<Char>

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

JsonException

Valore JSON non valido.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize(JsonNode, JsonTypeInfo)

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da .

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

Parametri

node: JsonNode

Oggetto JsonNode da convertire.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

Si applica a

Deserialize(Utf8JsonReader, JsonTypeInfo)

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Legge un valore JSON (inclusi gli oggetti o le matrici) dal lettore fornito in un'istanza specificata da 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

Parametri

reader: Utf8JsonReader

Lettore per eseguire la lettura.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

JsonException

Il valore JSON non è valido, jsonTypeInfo non è compatibile con il valore JSON oppure il lettore non è riuscito a leggere un valore.

ArgumentException

reader usa opzioni non supportate.

Commenti

Se la TokenType proprietà di reader è PropertyName o None, il lettore verrà avanzato da una chiamata a Read() per determinare l'inizio del valore.

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Si applica a

Deserialize(Stream, Type, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un oggetto returnType. Il flusso verrà letto fino al completamento.

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

Parametri

utf8Json: Stream

Dati JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante la lettura.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

utf8Json o returnType è null.

JsonException

Il codice JSON non è valido, non returnType è compatibile con il codice JSON o sono presenti dati rimanenti nel flusso.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

Si applica a

Deserialize(Stream, Type, JsonSerializerContext)

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un oggetto returnType. Il flusso verrà letto fino al completamento.

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

Parametri

utf8Json: Stream

Dati JSON da analizzare.

returnType: Type

Tipo dell'oggetto da convertire e restituire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Object

Rappresentazione returnType del valore JSON.

Eccezioni

ArgumentNullException

utf8Json, returnType o context è null.

JsonException

Il codice JSON non è valido, non returnType è compatibile con il codice JSON o sono presenti dati rimanenti nel flusso.

NotSupportedException

Non sono presenti JsonConverter compatibili per returnType o i membri serializzabili.

InvalidOperationException

Il GetTypeInfo(Type) metodo nell'oggetto fornito context non ha restituito un oggetto compatibile JsonTypeInfo per returnType.

Si applica a

Deserialize(JsonElement, JsonTypeInfo)

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un'istanza jsonTypeInfospecificata da .

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

Parametri

element: JsonElement

Oggetto JsonElement da convertire.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

Object

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

Si applica a

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

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Legge un valore JSON (inclusi gli oggetti o le matrici) dal lettore fornito in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

reader: Utf8JsonReader

Lettore per eseguire la lettura.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

Il valore JSON non è valido, TValue non è compatibile con il valore JSON oppure il lettore non è riuscito a leggere un valore.

ArgumentException

reader usa opzioni non supportate.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

Se la TokenType proprietà di reader è PropertyName o None, il lettore verrà avanzato da una chiamata a Read() per determinare l'inizio del valore.

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Si applica a

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

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

document: JsonDocument

Oggetto JsonDocument da convertire.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

document è null.

-oppure-

jsonTypeInfo è null.

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Origine:: JsonSerializer.Read.Utf8JsonReader.cs

Legge un valore JSON (inclusi oggetti o matrici) dal lettore specificato in un'istanza del tipo specificato da un parametro di tipo generico.

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

Parametri di tipo

TValue

Tipo di destinazione del valore JSON.

Parametri

reader: Utf8JsonReader

Lettore da cui leggere il valore JSON.

options: JsonSerializerOptions

Opzioni per controllare il comportamento del serializzatore durante la lettura.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Il lettore non è riuscito a leggere un valore.

ArgumentException

reader usa opzioni non supportate.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

Se la TokenType proprietà di reader è JsonTokenType.PropertyName o JsonTokenType.None, il lettore verrà avanzato da una chiamata a Utf8JsonReader.Read() per determinare l'inizio del valore.

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Oggetto JsonReaderOptions utilizzato per creare l'istanza di ha Utf8JsonReader la precedenza sull'oggetto JsonSerializerOptions quando sono in conflitto. Di conseguenza, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthe JsonReaderOptions.CommentHandling vengono usati durante la lettura.

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

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

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

node: JsonNode

Oggetto JsonNode da convertire.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Origine:: JsonSerializer.Read.Node.cs

Converte l'oggetto JsonNode che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

node: JsonNode

Oggetto JsonNode da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

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

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

element: JsonElement

Oggetto JsonElement da convertire.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Origine:: JsonSerializer.Read.Element.cs

Converte l'oggetto JsonElement che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

element: JsonElement

Oggetto JsonElement da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Origine:: JsonSerializer.Read.Document.cs

Converte l'oggetto JsonDocument che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

document: JsonDocument

Oggetto JsonDocument da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

document è null.

JsonException

TValue non è compatibile con il valore JSON.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

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

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

json: ReadOnlySpan<Char>

Il testo JSON da analizzare.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nell'intervallo oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

L'uso di un intervallo UTF-16 non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

Deserialize<TValue>(String, JsonSerializerOptions)

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.

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

Parametri di tipo

TValue

Tipo di destinazione del valore JSON.

Parametri

json: String

Il testo JSON da analizzare.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

json è null.

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

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

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

json: ReadOnlySpan<Char>

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

json è null.

-oppure-

jsonTypeInfo è null.

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

L'uso di un String oggetto non è altrettanto efficiente quanto l'uso dei metodi UTF-8 perché l'implementazione usa in modo nativo UTF-8.

Si applica a

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

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un oggetto 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

utf8Json: ReadOnlySpan<Byte>

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

Il codice JSON non è valido, TValue non è compatibile con il codice JSON o sono presenti dati rimanenti in Stream.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

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

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Origine:: JsonSerializer.Read.Span.cs

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza del tipo specificato da un parametro di tipo generico.

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

Parametri di tipo

TValue

Tipo di destinazione del testo con codifica UTF-8.

Parametri

utf8Json: ReadOnlySpan<Byte>

Il testo JSON da analizzare.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nell'intervallo oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

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

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un TValueoggetto . Il flusso verrà letto al completamento.

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

utf8Json: Stream

Dati JSON da analizzare.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

utf8Json o jsonTypeInfo è null.

JsonException

Il codice JSON non è valido, TValue non è compatibile con json o i dati rimanenti nel flusso.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Deserialize<TValue>(Stream, JsonSerializerOptions)

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Origine:: JsonSerializer.Read.Stream.cs

Legge il testo codificato UTF-8 che rappresenta un singolo valore JSON in un TValueoggetto . Il flusso verrà letto al completamento.

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

utf8Json: Stream

Dati JSON da analizzare.

options: JsonSerializerOptions

Opzioni per controllare il comportamento durante la lettura.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

utf8Json è null.

JsonException

Il codice JSON non è valido, TValue non è compatibile con json o i dati rimanenti nel flusso.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

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

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Origine:: JsonSerializer.Read.String.cs

Analizza il testo che rappresenta un singolo valore JSON in un TValueoggetto .

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

json: String

Testo JSON da analizzare.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

ArgumentNullException

json è null.

-oppure-

jsonTypeInfo è null.

JsonException

Valore JSON non valido.

-oppure-

TValue non è compatibile con il valore JSON.

-oppure-

Sono presenti dati rimanenti nella stringa oltre un valore JSON singolo.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

L'uso di un oggetto String non è efficiente come l'uso dei metodi UTF-8 poiché l'implementazione usa in modo nativo UTF-8.

Si applica a