JsonSerializer.Deserialize Méthode

Définition

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

utf8Json ou jsonTypeInfo est null.

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

Représentation returnType de la valeur JSON.

Exceptions

returnType ou context est null.

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.

reader utilise des options non prises en charge.

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

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

-ou-

context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

returnType n’est pas compatible avec le json.

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

-ou-

context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

returnType n’est pas compatible avec le json.

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

Représentation returnType de la valeur JSON.

Exceptions

document est null.

-ou-

returnType est null.

-ou-

context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

document ou returnType est null.

returnType n’est pas compatible avec le json.

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

Représentation returnType de la valeur JSON.

Exceptions

json ou returnType est null.

-ou-

context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

json ou returnType est null.

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.

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

Représentation returnType de la valeur JSON.

Exceptions

json ou returnType est null.

-ou-

context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

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.

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

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.

reader utilise des options non prises en charge.

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.

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

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.

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

Représentation returnType de la valeur JSON.

Exceptions

utf8Json, returnTypeou context est null.

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.

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

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

Représentation returnType de la valeur JSON.

Exceptions

utf8Json ou returnType est null.

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.

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

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.

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.

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

json est null.

-ou-

jsonTypeInfo est null.

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

jsonTypeInfo est null.

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

Représentation returnType de la valeur JSON.

Exceptions

returnType est null.

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.

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

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

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

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

TValue n’est pas compatible avec le json.

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

jsonTypeInfo est null.

TValue n’est pas compatible avec le json.

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

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.

reader utilise des options non prises en charge.

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.

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

jsonTypeInfo est null.

TValue n’est pas compatible avec le json.

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

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.

reader utilise des options non prises en charge.

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.

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

document est null.

-ou-

jsonTypeInfo est null.

TValue n’est pas compatible avec le json.

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

TValue n’est pas compatible avec le json.

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

document est null.

TValue n’est pas compatible avec le json.

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

json est null.

-ou-

jsonTypeInfo est null.

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.

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

json est null.

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.

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

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.

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

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.

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

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.

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

utf8Json ou jsonTypeInfo est null.

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.

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

utf8Json est null.

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.

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

json est null.

-ou-

jsonTypeInfo est null.

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.

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 à