JsonSerializer.Deserialize Méthode

Référence

Définition

Espace de noms:: System.Text.Json

Assembly:: System.Text.Json.dll

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Deserialize(Stream, JsonTypeInfo)	Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par .`jsonTypeInfo` Le flux sera lu jusqu’à la fin.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans un `returnType`.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Lit une valeur JSON (y compris des objets ou des tableaux) à partir du lecteur fourni et la convertit en instance d’un type spécifié.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Convertit le JsonNode représentant une seule valeur JSON en .`returnType`
Deserialize(JsonElement, Type, JsonSerializerContext)	Convertit le JsonElement représentant une seule valeur JSON en .`returnType`
Deserialize(JsonElement, Type, JsonSerializerOptions)	Convertit le JsonElement représentant une seule valeur JSON en .`returnType`
Deserialize(JsonDocument, Type, JsonSerializerContext)	Convertit le JsonDocument représentant une seule valeur JSON en .`returnType`
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Convertit le JsonDocument représentant une seule valeur JSON en .`returnType`
Deserialize(String, Type, JsonSerializerContext)	Analyse le texte représentant une seule valeur JSON dans un `returnType`.
Deserialize(String, Type, JsonSerializerOptions)	Analyse le texte représentant une valeur JSON unique dans une instance d’un type spécifié.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Analyse le texte représentant une seule valeur JSON dans un `returnType`.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Analyse le texte représentant une valeur JSON unique dans une instance d’un type spécifié.
Deserialize(JsonNode, Type, JsonSerializerContext)	Convertit le JsonNode représentant une seule valeur JSON en .`returnType`
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Analyse le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans un `returnType`.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par .`jsonTypeInfo`
Deserialize(String, JsonTypeInfo)	Analyse le texte représentant une seule valeur JSON dans un instance spécifié par .`jsonTypeInfo`
Deserialize(JsonDocument, JsonTypeInfo)	Convertit le JsonDocument représentant une valeur JSON unique en un instance spécifié par .`jsonTypeInfo`
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analyse le texte représentant une seule valeur JSON dans un instance spécifié par .`jsonTypeInfo`
Deserialize(JsonNode, JsonTypeInfo)	Convertit le JsonNode représentant une valeur JSON unique en un instance spécifié par .`jsonTypeInfo`
Deserialize(Utf8JsonReader, JsonTypeInfo)	Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans un instance spécifié par .`jsonTypeInfo`
Deserialize(Stream, Type, JsonSerializerOptions)	Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un `returnType`. Le flux sera lu jusqu’à la fin.
Deserialize(Stream, Type, JsonSerializerContext)	Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un `returnType`. Le flux sera lu jusqu’à la fin.
Deserialize(JsonElement, JsonTypeInfo)	Convertit le JsonElement représentant une valeur JSON unique en un instance spécifié par .`jsonTypeInfo`
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans un `TValue`.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Convertit le JsonDocument représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Lit une valeur JSON (notamment des objets ou des tableaux) à partir du lecteur fourni dans une instance du type spécifié par un paramètre de type générique.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Convertit le JsonNode représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Convertit le JsonNode représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Convertit le JsonElement représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Convertit le JsonElement représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Convertit le JsonDocument représentant une seule valeur JSON en .`TValue`
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analyse le texte représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.
Deserialize<TValue>(String, JsonSerializerOptions)	Analyse le texte représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analyse le texte représentant une seule valeur JSON dans un `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans un `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Analyse le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un `TValue`. Le flux sera lu jusqu’à la fin.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un `TValue`. Le flux sera lu jusqu’à la fin.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analyse le texte représentant une seule valeur JSON dans un `TValue`.

Deserialize(Stream, JsonTypeInfo)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par .jsonTypeInfo Le flux sera lu jusqu’à la fin.

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

Paramètres

utf8Json: Stream

Données JSON à analyser.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json ou jsonTypeInfo est null.

JsonException

Le code JSON n’est pas valide ou il reste des données dans le flux.

S’applique à

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans 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

Paramètres

reader: Utf8JsonReader

Lecteur à partir duquel effectuer la lecture.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType ou context est null.

JsonException

Le JSON n’est pas valide, returnType n’est pas compatible avec le JSON ou une valeur n’a pas pu être lue à partir du lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

La GetTypeInfo(Type) méthode sur le fourni context n’a pas retourné de compatible JsonTypeInfo pour returnType.

Remarques

Si la TokenType propriété de reader a la valeur PropertyName ou None, le lecteur est avancé d’un appel pour Read() déterminer le début de la valeur.

Une fois cette méthode terminée, reader est positionné au niveau du jeton final dans la valeur JSON. Si une exception est levée, le lecteur est réinitialisé à l’état dans lequel il se trouvait lorsque la méthode a été appelée.

Cette méthode effectue une copie des données sur laquelle le lecteur a agi, de sorte qu’il n’est pas nécessaire à l’appelant de maintenir l’intégrité des données au-delà du retour de cette méthode.

utilisé JsonReaderOptions pour créer le instance du Utf8JsonReader ont priorité sur le JsonSerializerOptions en cas de conflit. Par conséquent, AllowTrailingCommas, MaxDepthet CommentHandling sont utilisés lors de la lecture.

S’applique à

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lit une valeur JSON (y compris des objets ou des tableaux) à partir du lecteur fourni et la convertit en instance d’un type spécifié.

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

Paramètres

reader: Utf8JsonReader

Lecteur à partir duquel lire le JSON.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement du sérialiseur lors de la lecture.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Une valeur n’a pas pu être lue par le lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

Remarques

Si la TokenType propriété de reader a la valeur JsonTokenType.PropertyName ou JsonTokenType.None, le lecteur est avancé d’un appel pour Utf8JsonReader.Read() déterminer le début de la valeur.

utilisé JsonReaderOptions pour créer le instance du Utf8JsonReader ont priorité sur le JsonSerializerOptions en cas de conflit. Par conséquent, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthet JsonReaderOptions.CommentHandling sont utilisés lors de la lecture.

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

Deserialize(JsonNode, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique en .returnType

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

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

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

Paramètres

node: JsonNode

JsonNode à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

JsonException

returnType n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

S’applique à

Deserialize(JsonElement, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en .returnType

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

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

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

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

Paramètres

element: JsonElement

JsonElement à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

-ou-

context a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

Méthode GetTypeInfo(Type) des retours null fournis context pour le type à convertir.

S’applique à

Deserialize(JsonElement, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en .returnType

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

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

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

Paramètres

element: JsonElement

JsonElement à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

JsonException

returnType n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

S’applique à

Deserialize(JsonDocument, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en .returnType

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

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

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

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

Paramètres

document: JsonDocument

JsonDocument à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

document a la valeur null.

-ou-

returnType a la valeur null.

-ou-

context a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

Méthode GetTypeInfo(Type) des retours null fournis context pour le type à convertir.

S’applique à

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en .returnType

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

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

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

Paramètres

document: JsonDocument

JsonDocument à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

document ou returnType est null.

JsonException

returnType n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

S’applique à

Deserialize(String, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une seule valeur JSON dans 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

Paramètres

json: String

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

json ou returnType est null.

- ou -

context a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

Méthode GetTypeInfo(Type) des retours null fournis context pour le type à convertir.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

Deserialize(String, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance d’un type spécifié.

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

Paramètres

json: String

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

json ou returnType est null.

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une seule valeur JSON dans 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

Paramètres

json: ReadOnlySpan<Char>

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

json ou returnType est null.

- ou -

context a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

La GetTypeInfo(Type) méthode du fourni context retourne null le type à convertir.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance d’un type spécifié.

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

Paramètres

json: ReadOnlySpan<Char>

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

Remarques

L’utilisation d’une étendue UTF-16 n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une seule valeur JSON en .returnType

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

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

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

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

Paramètres

node: JsonNode

JsonNode à convertir.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

-ou-

context a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

La GetTypeInfo(Type) méthode du fourni context retourne null le type à convertir.

S’applique à

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analyse le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié.

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

Paramètres

utf8Json: ReadOnlySpan<Byte>

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

returnType n’est pas compatible avec le JSON.

- ou -

Données restantes au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

Remarques

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans 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

Paramètres

utf8Json: ReadOnlySpan<Byte>

Texte JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType a la valeur null.

JsonException

Le json n’est pas valide, returnType n’est pas compatible avec le JSON ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

La GetTypeInfo(Type) méthode sur le fourni context n’a pas retourné de compatible JsonTypeInfo pour returnType.

S’applique à

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par .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

Paramètres

utf8Json: ReadOnlySpan<Byte>

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

JsonException

Le json n’est pas valide ou il reste des données dans la mémoire tampon.

S’applique à

Deserialize(String, JsonTypeInfo)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans un instance spécifié par le 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

Paramètres

json: String

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

json a la valeur null.

-ou-

jsonTypeInfo a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

Deserialize(JsonDocument, JsonTypeInfo)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en un instance spécifié par le 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

Paramètres

document: JsonDocument

JsonDocument à convertir.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

document a la valeur null.

-ou-

jsonTypeInfo a la valeur null.

S’applique à

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans un instance spécifié par le 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

Paramètres

json: ReadOnlySpan<Char>

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

Deserialize(JsonNode, JsonTypeInfo)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique en un instance spécifié par le 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

Paramètres

node: JsonNode

JsonNode à convertir.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

S’applique à

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans un instance spécifié par .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

Paramètres

reader: Utf8JsonReader

Lecteur à partir duquel effectuer la lecture.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

JsonException

Le JSON n’est pas valide, jsonTypeInfo n’est pas compatible avec le JSON ou une valeur n’a pas pu être lue à partir du lecteur.

ArgumentException

reader utilise des options non prises en charge.

Remarques

Si la TokenType propriété de reader a la valeur PropertyName ou None, le lecteur est avancé d’un appel pour Read() déterminer le début de la valeur.

S’applique à

Deserialize(Stream, Type, JsonSerializerOptions)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu jusqu’à la fin.

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

Paramètres

utf8Json: Stream

Données JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de la lecture.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json ou returnType est null.

JsonException

Le JSON n’est pas valide, le returnType n’est pas compatible avec le JSON ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

S’applique à

Deserialize(Stream, Type, JsonSerializerContext)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu jusqu’à la fin.

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

Paramètres

utf8Json: Stream

Données JSON à analyser.

returnType: Type

Type de l’objet à convertir et à retourner.

context: JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json, returnType ou context est null.

JsonException

Le JSON n’est pas valide, le returnType n’est pas compatible avec le JSON ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

La GetTypeInfo(Type) méthode sur le fourni context n’a pas retourné de compatible JsonTypeInfo pour returnType.

S’applique à

Deserialize(JsonElement, JsonTypeInfo)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en un instance spécifié par le 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

Paramètres

element: JsonElement

JsonElement à convertir.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

S’applique à

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

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lit une valeur JSON (y compris des objets ou des tableaux) du lecteur fourni dans 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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

reader: Utf8JsonReader

Lecteur à partir duquel effectuer la lecture.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le JSON n’est pas valide, TValue n’est pas compatible avec le JSON ou une valeur n’a pas pu être lue à partir du lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

Si la TokenType propriété de reader a la valeur PropertyName ou None, le lecteur est avancé d’un appel pour Read() déterminer le début de la valeur.

S’applique à

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

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en .TValue

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

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

document: JsonDocument

JsonDocument à convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

document a la valeur null.

-ou-

jsonTypeInfo a la valeur null.

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Source:: JsonSerializer.Read.Utf8JsonReader.cs

Lit une valeur JSON (notamment des objets ou des tableaux) à partir du lecteur fourni dans une instance du type spécifié par un paramètre de type générique.

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

Paramètres de type

TValue

Type cible de la valeur JSON.

Paramètres

reader: Utf8JsonReader

Lecteur à partir duquel lire le JSON.

options: JsonSerializerOptions

Options permettant de contrôler le comportement du sérialiseur lors de la lecture.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Une valeur n’a pas pu être lue par le lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

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

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique en .TValue

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

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

node: JsonNode

JsonNode à convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Source:: JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique en .TValue

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

node: JsonNode

JsonNode à convertir.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

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

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en .TValue

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

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

element: JsonElement

JsonElement à convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Source:: JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en .TValue

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

element: JsonElement

JsonElement à convertir.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Source:: JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en .TValue

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

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

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

document: JsonDocument

JsonDocument à convertir.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

document a la valeur null.

JsonException

TValue n’est pas compatible avec le JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

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

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

json: ReadOnlySpan<Char>

Texte JSON à analyser.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

L’utilisation d’une étendue UTF-16 n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise UTF-8 en mode natif.

S’applique à

Deserialize<TValue>(String, JsonSerializerOptions)

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.

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

Paramètres de type

TValue

Type cible de la valeur JSON.

Paramètres

json: String

Texte JSON à analyser.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

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

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une seule valeur JSON dans 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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

json: ReadOnlySpan<Char>

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json a la valeur null.

-ou-

jsonTypeInfo a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à

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

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une seule valeur JSON dans 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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

utf8Json: ReadOnlySpan<Byte>

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le json n’est pas valide, TValue n’est pas compatible avec le json ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

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

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Source:: JsonSerializer.Read.Span.cs

Analyse le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance du type spécifié par un paramètre de type générique.

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

Paramètres de type

TValue

Type cible du texte encodé en UTF-8.

Paramètres

utf8Json: ReadOnlySpan<Byte>

Texte JSON à analyser.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

Pour plus d’informations, consultez Comment sérialiser et désérialiser JSON.

S’applique à

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

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un TValue. Le flux sera lu jusqu’à la fin.

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

utf8Json: Stream

Données JSON à analyser.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json ou jsonTypeInfo est null.

JsonException

Le json n’est pas valide, TValue n’est pas compatible avec le JSON ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

Deserialize<TValue>(Stream, JsonSerializerOptions)

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Source:: JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un TValue. Le flux sera lu jusqu’à la fin.

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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

utf8Json: Stream

Données JSON à analyser.

options: JsonSerializerOptions

Options permettant de contrôler le comportement lors de la lecture.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json a la valeur null.

JsonException

Le json n’est pas valide, TValue n’est pas compatible avec le JSON ou il reste des données dans le flux.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

S’applique à

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

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Source:: JsonSerializer.Read.String.cs

Analyse le texte représentant une seule valeur JSON dans 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

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

json: String

Texte JSON à analyser.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json a la valeur null.

-ou-

jsonTypeInfo a la valeur null.

JsonException

Le JSON n’est pas valide.

- ou -

TValue n’est pas compatible avec le JSON.

- ou -

Données restantes dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

L’utilisation d’un String n’est pas aussi efficace que l’utilisation des méthodes UTF-8, car l’implémentation utilise en mode natif UTF-8.

S’applique à