JsonSerializer.Deserialize Méthode

Référence

Définition

Espace de noms:: System.Text.Json

Assembly:: System.Text.Json.dll

Paquet:: System.Text.Json v8.0.5

Paquet:: System.Text.Json v9.0.0-rc.2.24473.5

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

S’applique à

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:: JsonSerializer.Read.Utf8JsonReader.cs

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

S’applique à

Partager via

JsonSerializer.Deserialize Méthode

Définition

Surcharges

Deserialize(Stream, JsonTypeInfo)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(JsonNode, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(JsonNode, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(JsonElement, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(JsonElement, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(JsonDocument, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

S’applique à

Deserialize(String, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(String, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Paramètres

Retours

Exceptions

Remarques