Condividi tramite


JsonSerializer.Deserialize Metodo

Definizione

Overload

Deserialize(Stream, JsonTypeInfo)

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo. Il flusso verrà letto fino al completamento.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un returnType.

Deserialize(JsonNode, Type, JsonSerializerContext)

Converte il JsonNode che rappresenta un singolo valore JSON in un returnType.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Converte il JsonNode che rappresenta un singolo valore JSON in un returnType.

Deserialize(JsonElement, Type, JsonSerializerContext)

Converte il JsonElement che rappresenta un singolo valore JSON in un returnType.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Converte il JsonElement che rappresenta un singolo valore JSON in un returnType.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Converte il JsonDocument che rappresenta un singolo valore JSON in un returnType.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Converte il JsonDocument che rappresenta un singolo valore JSON in un returnType.

Deserialize(String, Type, JsonSerializerContext)

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

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

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

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(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(Stream, Type, JsonSerializerContext)

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

Deserialize(Stream, Type, JsonSerializerOptions)

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

Deserialize(Utf8JsonReader, JsonTypeInfo)

Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un'istanza specificata dal jsonTypeInfo.

Deserialize(JsonNode, JsonTypeInfo)

Converte il JsonNode che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize(JsonElement, JsonTypeInfo)

Converte il JsonElement che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize(JsonDocument, JsonTypeInfo)

Converte il JsonDocument che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize(String, JsonTypeInfo)

Analizza il testo che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Analizza il testo che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un returnType.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Converte il JsonElement che rappresenta un singolo valore JSON in un TValue.

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

Converte il JsonElement che rappresenta un singolo valore JSON in un TValue.

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

Legge un valore JSON (inclusi oggetti o matrici) dal lettore fornito in un TValue.

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

Converte il JsonNode che rappresenta un singolo valore JSON in un TValue.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

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

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

Converte il JsonDocument che rappresenta un singolo valore JSON in un TValue.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Converte il JsonNode che rappresenta un singolo valore JSON in un TValue.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Converte il JsonDocument che rappresenta un singolo valore JSON in un TValue.

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

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

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

Analizza il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue.

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 con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue. Il flusso verrà letto fino al completamento.

Deserialize<TValue>(Stream, JsonSerializerOptions)

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

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

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

Deserialize(Stream, JsonTypeInfo)

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'istanza specificata dal jsonTypeInfo. Il flusso verrà letto fino 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

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

utf8Json o jsonTypeInfo è null.

Il codice JSON non è valido o nel flusso sono presenti dati rimanenti.

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 oggetti o matrici) dal lettore fornito in 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

Parametri

reader
Utf8JsonReader

Lettore da leggere.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType o context è null.

Il codice JSON non è valido, returnType non è compatibile con il codice JSON o non è stato possibile leggere un valore dal lettore.

reader usa opzioni non supportate.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

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

Commenti

Se la proprietà TokenType 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 ha agito, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Il JsonReaderOptions utilizzato per creare l'istanza del Utf8JsonReader ha la precedenza sul JsonSerializerOptions quando sono in conflitto. Di conseguenza, AllowTrailingCommas, MaxDepthe CommentHandling vengono usati durante la lettura.

Si applica a

Deserialize(JsonNode, Type, JsonSerializerContext)

Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs

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

Parametri

node
JsonNode

JsonNode da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

-o-

context è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) del context fornito restituisce null per il tipo da convertire.

Si applica a

Deserialize(JsonNode, Type, JsonSerializerOptions)

Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs

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

Parametri

node
JsonNode

JsonNode da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi 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 il JsonElement che rappresenta un singolo valore JSON in 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

Parametri

element
JsonElement

JsonElement da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

-o-

context è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) del context fornito restituisce null 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 il JsonElement che rappresenta un singolo valore JSON in 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

Parametri

element
JsonElement

JsonElement da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

returnType non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi 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 il JsonDocument che rappresenta un singolo valore JSON in 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

Parametri

document
JsonDocument

JsonDocument da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

document è null.

-o-

returnType è null.

-o-

context è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) del context fornito restituisce null 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 il JsonDocument che rappresenta un singolo valore JSON in 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

Parametri

document
JsonDocument

JsonDocument da convertire.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

document o returnType è null.

returnType non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi 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 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 in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

json o returnType è null.

-o-

context è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) del context fornito restituisce null per il tipo da convertire.

Commenti

L'uso di un String non è altrettanto efficiente dell'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

Testo JSON da analizzare.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

json o returnType è null.

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Commenti

L'uso di un String non è altrettanto efficiente dell'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 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 in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

json o returnType è null.

-o-

context è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) del context fornito restituisce null per il tipo da convertire.

Commenti

L'uso di un String non è altrettanto efficiente dell'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>

Testo JSON da analizzare.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

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

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Commenti

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

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 oggetti o 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 codice JSON.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento del serializzatore durante la lettura.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

Impossibile leggere un valore dal lettore.

reader usa opzioni non supportate.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Commenti

Se la proprietà TokenType 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 verrà 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 ha agito, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Il JsonReaderOptions utilizzato per creare l'istanza del Utf8JsonReader ha la precedenza sul 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(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>

Testo JSON da analizzare.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

JSON non valido.

-o-

returnType non è compatibile con json.

-o-

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

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

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 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 in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

utf8Json, returnTypeo context è null.

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

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

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

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 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 in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante la lettura.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

utf8Json o returnType è null.

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

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Si applica a

Deserialize(Utf8JsonReader, JsonTypeInfo)

Origine:
JsonSerializer.Read.Utf8JsonReader.cs
Origine:
JsonSerializer.Read.Utf8JsonReader.cs

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

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

Il codice JSON non è valido, jsonTypeInfo non è compatibile con il codice JSON o non è stato possibile leggere un valore dal lettore.

reader usa opzioni non supportate.

Commenti

Se la proprietà TokenType 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 verrà 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 ha agito, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Il JsonReaderOptions utilizzato per creare l'istanza del Utf8JsonReader ha la precedenza sul JsonSerializerOptions quando sono in conflitto. Di conseguenza, AllowTrailingCommas, MaxDepthe CommentHandling vengono usati durante la lettura.

Si applica a

Deserialize(JsonNode, JsonTypeInfo)

Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs

Converte il JsonNode che rappresenta un singolo valore JSON in un'istanza specificata dal 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

Parametri

node
JsonNode

JsonNode da convertire.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

jsonTypeInfo è null.

Si applica a

Deserialize(JsonElement, JsonTypeInfo)

Origine:
JsonSerializer.Read.Element.cs
Origine:
JsonSerializer.Read.Element.cs

Converte il JsonElement che rappresenta un singolo valore JSON in un'istanza specificata dal 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

Parametri

element
JsonElement

JsonElement da convertire.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

jsonTypeInfo è null.

Si applica a

Deserialize(JsonDocument, JsonTypeInfo)

Origine:
JsonSerializer.Read.Document.cs
Origine:
JsonSerializer.Read.Document.cs

Converte il JsonDocument che rappresenta un singolo valore JSON in un'istanza specificata dal 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

Parametri

document
JsonDocument

JsonDocument da convertire.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

document è null.

-o-

jsonTypeInfo è null.

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

Parametri

json
String

Testo JSON da analizzare.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

json è null.

-o-

jsonTypeInfo è null.

JSON non valido.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Commenti

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

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

Parametri

json
ReadOnlySpan<Char>

Testo JSON da analizzare.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

jsonTypeInfo è null.

JSON non valido.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Commenti

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

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 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 in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

returnType è null.

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

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) nel context fornito non ha restituito un JsonTypeInfo compatibile 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 dal 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 sul tipo da convertire.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

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

Si applica a

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Origine:
JsonSerializer.Read.Element.cs
Origine:
JsonSerializer.Read.Element.cs
Origine:
JsonSerializer.Read.Element.cs

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

element
JsonElement

JsonElement da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 il JsonElement che rappresenta un singolo valore JSON in 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

element
JsonElement

JsonElement da convertire.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

jsonTypeInfo è null.

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

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 oggetti o matrici) dal lettore fornito in 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

reader
Utf8JsonReader

Lettore da leggere.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

Il codice JSON non è valido, TValue non è compatibile con il codice JSON o non è stato possibile leggere un valore dal lettore.

reader usa opzioni non supportate.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

Se la proprietà TokenType 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 ha agito, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Il JsonReaderOptions utilizzato per creare l'istanza del Utf8JsonReader ha la precedenza sul JsonSerializerOptions quando sono in conflitto. Di conseguenza, AllowTrailingCommas, MaxDepthe CommentHandling vengono usati durante la lettura.

Si applica a

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

Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs
Origine:
JsonSerializer.Read.Node.cs

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

node
JsonNode

JsonNode da convertire.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

jsonTypeInfo è null.

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 fornito 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 codice JSON.

options
JsonSerializerOptions

Opzioni per controllare il comportamento del serializzatore durante la lettura.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Impossibile leggere un valore dal lettore.

reader usa opzioni non supportate.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

Se la proprietà TokenType 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 verrà 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 ha agito, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.

Il JsonReaderOptions utilizzato per creare l'istanza del Utf8JsonReader ha la precedenza sul 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>(JsonDocument, JsonTypeInfo<TValue>)

Origine:
JsonSerializer.Read.Document.cs
Origine:
JsonSerializer.Read.Document.cs
Origine:
JsonSerializer.Read.Document.cs

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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

document
JsonDocument

JsonDocument da convertire.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

document è null.

-o-

jsonTypeInfo è null.

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 il JsonNode che rappresenta un singolo valore JSON in 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

node
JsonNode

JsonNode da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 il JsonDocument che rappresenta un singolo valore JSON in 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

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

document
JsonDocument

JsonDocument da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

document è null.

TValue non è compatibile con json.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

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 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 sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

json è null.

-o-

jsonTypeInfo è null.

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

L'uso di un String non è altrettanto efficiente dell'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

Testo JSON da analizzare.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

json è null.

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

L'uso di un String non è altrettanto efficiente dell'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>, 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>

Testo JSON da analizzare.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

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

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

L'uso di un intervallo UTF-16 non è altrettanto efficiente dell'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 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 sul tipo da convertire.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

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

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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>

Testo JSON da analizzare.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante l'analisi.

Restituisce

TValue

Rappresentazione TValue del valore JSON.

Eccezioni

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

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

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue. Il flusso verrà letto fino 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

utf8Json o jsonTypeInfo è null.

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

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue. Il flusso verrà letto fino 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

utf8Json è null.

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

Non esiste alcuna JsonConverter compatibile per TValue o i relativi 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 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

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

json è null.

-o-

jsonTypeInfo è null.

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nella stringa sono presenti dati rimanenti oltre un singolo valore JSON.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Commenti

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

Si applica a