JsonSerializer.Deserialize Méthode

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Surcharges

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

Deserialize(Stream, JsonTypeInfo)

Source:

JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans une instance spécifiée par le jsonTypeInfo. Le flux sera lu à 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 sur le 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 existe des données restantes dans le flux.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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 à lire.

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 code 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 aucune JsonConverter compatible pour returnType ou ses membres sérialisables.

InvalidOperationException

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

Remarques

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

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

Cette méthode effectue une copie des données sur laquelle le lecteur a agi. Il n’existe donc aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.

Les JsonReaderOptions utilisées pour créer l’instance du Utf8JsonReader sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en conflit. Par conséquent, AllowTrailingCommas, MaxDepthet CommentHandling sont utilisés lors de la lecture.

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique 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 est null.

-ou-

context est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonNode, Type, JsonSerializerOptions)

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 pendant 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 aucune JsonConverter compatible pour returnType ou ses membres sérialisables.

Deserialize(JsonElement, Type, JsonSerializerContext)

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 est null.

-ou-

context est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonElement, Type, JsonSerializerOptions)

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 pendant l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType est null.

JsonException

returnType n’est pas compatible avec le json.

NotSupportedException

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

Deserialize(JsonDocument, Type, JsonSerializerContext)

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 est null.

-ou-

returnType est null.

-ou-

context est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonDocument, Type, JsonSerializerOptions)

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 pendant 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 aucune JsonConverter compatible pour returnType ou ses membres sérialisables.

Deserialize(String, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique 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 est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

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

InvalidOperationException

La méthode GetTypeInfo(Type) du context fourni retourne null 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.

Deserialize(String, Type, JsonSerializerOptions)

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

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

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 pendant l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

json ou returnType est null.

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique 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 est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

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

InvalidOperationException

La méthode GetTypeInfo(Type) du context fourni retourne null 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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

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 pendant l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans l’étendue au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

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

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

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 pendant la lecture.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Impossible de lire une valeur à partir du lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

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

Remarques

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

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

Cette méthode effectue une copie des données sur laquelle le lecteur a agi. Il n’existe donc aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.

Les JsonReaderOptions utilisées pour créer l’instance du Utf8JsonReader sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en 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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Span.cs

Analyse le texte encodé 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);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

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 pendant l’analyse.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

returnType est null.

JsonException

Le code JSON n’est pas valide.

-ou-

returnType n’est pas compatible avec le json.

-ou-

Il reste des données dans l’étendue au-delà d’une seule valeur JSON.

NotSupportedException

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

Remarques

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

Deserialize(Stream, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu à 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, returnTypeou context est null.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(Stream, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu à 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 pendant la lecture.

Retours

Object

Représentation returnType de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json ou returnType est null.

JsonException

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

NotSupportedException

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

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

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

jsonTypeInfo

JsonTypeInfo

Métadonnées sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

JsonException

Le code 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 propriété TokenType de reader est PropertyName ou None, le lecteur est avancé par un appel à Read() pour déterminer le début de la valeur.

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

Cette méthode effectue une copie des données sur laquelle le lecteur a agi. Il n’existe donc aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.

Les JsonReaderOptions utilisées pour créer l’instance du Utf8JsonReader sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en conflit. Par conséquent, AllowTrailingCommas, MaxDepthet CommentHandling sont utilisés lors de la lecture.

Deserialize(JsonNode, JsonTypeInfo)

Source:

JsonSerializer.Read.Node.cs

Convertit le JsonNode représentant une valeur JSON unique en une instance spécifiée 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo est null.

Deserialize(JsonElement, JsonTypeInfo)

Source:

JsonSerializer.Read.Element.cs

Convertit le JsonElement représentant une valeur JSON unique en une instance spécifiée 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo est null.

Deserialize(JsonDocument, JsonTypeInfo)

Source:

JsonSerializer.Read.Document.cs

Convertit le JsonDocument représentant une valeur JSON unique en une instance spécifiée 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

document est null.

-ou-

jsonTypeInfo est null.

Deserialize(String, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance spécifiée 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

json est null.

-ou-

jsonTypeInfo est null.

JsonException

Le code JSON n’est pas valide.

-ou-

Il reste des données 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.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique dans une instance spécifiée 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo est null.

JsonException

Le code JSON n’est pas valide.

-ou-

Il reste des données 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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une valeur JSON unique 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 est null.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:

JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une valeur JSON unique dans une instance spécifiée par le 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 sur le type à convertir.

Retours

Object

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

JsonException

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

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

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 pendant 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 aucune JsonConverter compatible pour TValue ou ses membres sérialisables.

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

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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo est null.

JsonException

TValue n’est pas compatible avec le json.

NotSupportedException

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

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

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 à lire.

jsonTypeInfo

JsonTypeInfo<TValue>

Métadonnées sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le code 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 aucune JsonConverter compatible pour TValue ou ses membres sérialisables.

Remarques

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

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

Cette méthode effectue une copie des données sur laquelle le lecteur a agi. Il n’existe donc aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.

Les JsonReaderOptions utilisées pour créer l’instance du Utf8JsonReader sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en conflit. Par conséquent, AllowTrailingCommas, MaxDepthet CommentHandling sont utilisés lors de la lecture.

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

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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

jsonTypeInfo est null.

JsonException

TValue n’est pas compatible avec le json.

NotSupportedException

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

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

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

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

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 pendant la lecture.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Impossible de lire une valeur à partir du lecteur.

ArgumentException

reader utilise des options non prises en charge.

NotSupportedException

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

Remarques

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

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

Cette méthode effectue une copie des données sur laquelle le lecteur a agi. Il n’existe donc aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.

Les JsonReaderOptions utilisées pour créer l’instance du Utf8JsonReader sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en 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.

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

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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

document est null.

-ou-

jsonTypeInfo est null.

JsonException

TValue n’est pas compatible avec le json.

NotSupportedException

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

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

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 pendant 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 aucune JsonConverter compatible pour TValue ou ses membres sérialisables.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

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 pendant l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

document est null.

JsonException

TValue n’est pas compatible avec le json.

NotSupportedException

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

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

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique 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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json est null.

-ou-

jsonTypeInfo est null.

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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.

Deserialize<TValue>(String, JsonSerializerOptions)

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

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

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 pendant l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json est null.

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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.

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

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 pendant l’analyse.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans l’étendue au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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 en mode natif UTF-8.

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

Source:

JsonSerializer.Read.Span.cs

Analyse le texte encodé UTF-8 représentant une valeur JSON unique 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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

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

NotSupportedException

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

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

Source:

JsonSerializer.Read.Span.cs

Analyse le texte encodé 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);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

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é UTF-8.

Paramètres

utf8Json

ReadOnlySpan<Byte>

Texte JSON à analyser.

options

JsonSerializerOptions

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

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans l’étendue au-delà d’une seule valeur JSON.

NotSupportedException

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

Remarques

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

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

Source:

JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un TValue. Le flux sera lu à 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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json ou jsonTypeInfo est null.

JsonException

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

NotSupportedException

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

Deserialize<TValue>(Stream, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un TValue. Le flux sera lu à 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 pendant la lecture.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

utf8Json est null.

JsonException

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

NotSupportedException

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

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

Source:

JsonSerializer.Read.String.cs

Analyse le texte représentant une valeur JSON unique 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 sur le type à convertir.

Retours

TValue

Représentation TValue de la valeur JSON.

Exceptions

ArgumentNullException

json est null.

-ou-

jsonTypeInfo est null.

JsonException

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il reste des données dans la chaîne au-delà d’une seule valeur JSON.

NotSupportedException

Il n’existe aucune 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.