JsonSerializer.Serialize Méthode
Définition
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
| Serialize(Stream, Object, Type, JsonSerializerContext) |
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Écrit la représentation JSON du type spécifié dans l’enregistreur fourni. |
| Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni. |
| Serialize(Stream, Object, Type, JsonSerializerOptions) |
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream. |
| Serialize(Object, Type, JsonSerializerOptions) |
Convertit la valeur d’un type spécifié en chaîne JSON. |
| Serialize(Stream, Object, JsonTypeInfo) |
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream. |
| Serialize(Object, JsonTypeInfo) |
Convertit la valeur fournie en String. |
| Serialize(Object, Type, JsonSerializerContext) |
Convertit la valeur fournie en String. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Écrit la représentation JSON d’un type spécifié par un paramètre de type générique dans l’enregistreur fourni. |
| Serialize<TValue>(TValue, JsonSerializerOptions) |
Convertit la valeur d’un type spécifié par un paramètre de type générique en chaîne JSON. |
| Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Convertit la valeur fournie en String. |
| Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream. |
| Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni. |
Serialize(Stream, Object, Type, JsonSerializerContext)
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)Paramètres
- value
- Object
Valeur à convertir.
- inputType
- Type
Type du value à convertir.
- context
- JsonSerializerContext
Fournisseur de métadonnées pour les types sérialisables.
Exceptions
inputType n’est pas compatible avec value.
utf8Json, inputTypeou context est null.
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
S’applique à
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, context As JsonSerializerContext)Paramètres
- writer
- Utf8JsonWriter
Enregistreur JSON dans lequel écrire.
- value
- Object
Valeur à convertir et à écrire.
- inputType
- Type
Type du value à convertir.
- context
- JsonSerializerContext
Fournisseur de métadonnées pour les types sérialisables.
Exceptions
inputType n’est pas compatible avec value.
writer ou inputType est null.
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
La méthode GetTypeInfo(Type) du context fourni retourne null pour le type à convertir.
S’applique à
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Écrit la représentation JSON du type spécifié dans l’enregistreur fourni.
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Paramètres
- writer
- Utf8JsonWriter
Enregistreur JSON dans lequel écrire.
- value
- Object
Valeur à convertir et à écrire.
- inputType
- Type
Type du value à convertir.
- options
- JsonSerializerOptions
Options pour contrôler le comportement de sérialisation.
Exceptions
inputType n’est pas compatible avec value
writer ou inputType est null.
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
Remarques
Les JsonWriterOptions utilisées pour créer l’instance du Utf8JsonWriter sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en conflit. Par conséquent, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationet JsonWriterOptions.Encoder sont utilisés lors de l’écriture.
Pour plus d’informations, consultez Comment sérialiser et désérialiser json.
S’applique à
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)Paramètres
- writer
- Utf8JsonWriter
Enregistreur à écrire.
- value
- Object
Valeur à convertir et à écrire.
- jsonTypeInfo
- JsonTypeInfo
Métadonnées sur le type à convertir.
Exceptions
writer ou jsonTypeInfo est null.
value ne correspond pas au type de jsonTypeInfo.
S’applique à
Serialize(Stream, Object, Type, JsonSerializerOptions)
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream.
public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Paramètres
- value
- Object
Valeur à convertir.
- inputType
- Type
Type du value à convertir.
- options
- JsonSerializerOptions
Options permettant de contrôler le comportement de conversion.
Exceptions
inputType n’est pas compatible avec value.
utf8Json ou inputType est null.
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
S’applique à
Serialize(Object, Type, JsonSerializerOptions)
Convertit la valeur d’un type spécifié en chaîne JSON.
public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize (object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As StringParamètres
- value
- Object
Valeur à convertir.
- inputType
- Type
Type du value à convertir.
- options
- JsonSerializerOptions
Options permettant de contrôler le comportement de conversion.
Retours
Représentation sous forme de chaîne JSON de la valeur.
Exceptions
inputType n’est pas compatible avec value.
inputType est null.
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
Remarques
L’utilisation d’un String n’est pas aussi efficace que l’encodage UTF-8, car l’implémentation utilise en interne UTF-8. Voir aussi SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) et SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Pour plus d’informations, consultez Comment sérialiser et désérialiser json.
S’applique à
Serialize(Stream, Object, JsonTypeInfo)
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)Paramètres
- value
- Object
Valeur à convertir.
- jsonTypeInfo
- JsonTypeInfo
Métadonnées sur le type à convertir.
Exceptions
utf8Json est null.
value ne correspond pas au type de jsonTypeInfo.
S’applique à
Serialize(Object, JsonTypeInfo)
Convertit la valeur fournie en String.
public:
static System::String ^ Serialize(System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static string Serialize (object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> stringPublic Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As StringParamètres
- value
- Object
Valeur à convertir.
- jsonTypeInfo
- JsonTypeInfo
Métadonnées sur le type à convertir.
Retours
Représentation String de la valeur.
Exceptions
jsonTypeInfo est null.
value ne correspond pas au type de jsonTypeInfo.
Remarques
L’utilisation d’un String n’est pas aussi efficace que l’encodage UTF-8, car l’implémentation utilise en interne UTF-8. Voir aussi SerializeToUtf8Bytes(Object, JsonTypeInfo) et SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
S’applique à
Serialize(Object, Type, JsonSerializerContext)
Convertit la valeur fournie en String.
public:
static System::String ^ Serialize(System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static string Serialize (object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> stringPublic Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As StringParamètres
- value
- Object
Valeur à convertir.
- inputType
- Type
Type du value à convertir.
- context
- JsonSerializerContext
Fournisseur de métadonnées pour les types sérialisables.
Retours
Représentation String de la valeur.
Exceptions
Il n’existe aucune JsonConverter compatible pour inputType ou ses membres sérialisables.
La méthode GetTypeInfo(Type) du context fourni retourne null pour le type à convertir.
inputType ou context est null.
Remarques
L’utilisation d’un String n’est pas aussi efficace que l’utilisation de l’encodage UTF-8, car l’implémentation utilise en interne UTF-8. Voir également SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) et SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
S’applique à
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Écrit la représentation JSON d’un type spécifié par un paramètre de type générique dans l’enregistreur fourni.
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)Paramètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- writer
- Utf8JsonWriter
Enregistreur JSON dans lequel écrire.
- value
- TValue
Valeur à convertir et à écrire.
- options
- JsonSerializerOptions
Options pour contrôler le comportement de sérialisation.
Exceptions
writer est null.
Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.
Remarques
Les JsonWriterOptions utilisées pour créer l’instance du Utf8JsonWriter sont prioritaires sur les JsonSerializerOptions lorsqu’elles sont en conflit. Par conséquent, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationet JsonWriterOptions.Encoder sont utilisés lors de l’écriture.
Pour plus d’informations, consultez Comment sérialiser et désérialiser json.
S’applique à
Serialize<TValue>(TValue, JsonSerializerOptions)
Convertit la valeur d’un type spécifié par un paramètre de type générique en chaîne JSON.
public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As StringParamètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- value
- TValue
Valeur à convertir.
- options
- JsonSerializerOptions
Options pour contrôler le comportement de sérialisation.
Retours
Représentation sous forme de chaîne JSON de la valeur.
Exceptions
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’encodage UTF-8, car l’implémentation utilise en interne UTF-8. Voir aussi SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) et SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Pour plus d’informations, consultez Comment sérialiser et désérialiser json.
S’applique à
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Convertit la valeur fournie en String.
public:
generic <typename TValue>
static System::String ^ Serialize(TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static string Serialize<TValue> (TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> stringPublic Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As StringParamètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- value
- TValue
Valeur à convertir.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Métadonnées sur le type à convertir.
Retours
Représentation String de la valeur.
Exceptions
Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.
jsonTypeInfo est null.
Remarques
L’utilisation d’un String n’est pas aussi efficace que l’encodage UTF-8, car l’implémentation utilise en interne UTF-8. Voir aussi SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) et SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
S’applique à
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream.
public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)Paramètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- value
- TValue
Valeur à convertir.
- options
- JsonSerializerOptions
Options permettant de contrôler le comportement de conversion.
Exceptions
utf8Json est null.
Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.
S’applique à
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans le Stream.
public:
generic <typename TValue>
static void Serialize(System::IO::Stream ^ utf8Json, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))Paramètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- value
- TValue
Valeur à convertir.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Métadonnées sur le type à convertir.
Exceptions
utf8Json est null.
Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.
S’applique à
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni.
public:
generic <typename TValue>
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))Paramètres de type
- TValue
Type de la valeur à sérialiser.
Paramètres
- writer
- Utf8JsonWriter
Enregistreur à écrire.
- value
- TValue
Valeur à convertir et à écrire.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Métadonnées sur le type à convertir.
Exceptions
writer ou jsonTypeInfo est null.
Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.
