JsonSerializer.Serialize Méthode

Référence

Définition

Espace de noms:: System.Text.Json

Assembly:: System.Text.Json.dll

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

Important

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

Surcharges

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	É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 .Stream
Serialize(Stream, Object, Type, JsonSerializerOptions)	Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .Stream
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	É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(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 .Stream
Serialize(Object, JsonTypeInfo)	Convertit la valeur fournie en .String
Serialize(Object, Type, JsonSerializerContext)	Convertit la valeur fournie en .String
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 .Stream
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .Stream
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>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Écrit une valeur JSON (y compris des objets ou des tableaux) dans l’enregistreur fourni.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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 de value à convertir.

context: JsonSerializerContext

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

Exceptions

ArgumentException

inputType n'est pas compatible avec value.

ArgumentNullException

writer ou inputType est null.

NotSupportedException

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

InvalidOperationException

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

S’applique à

Serialize(Stream, Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)

Paramètres

utf8Json: Stream

UTF-8 Stream dans lequel écrire.

value: Object

Valeur à convertir.

inputType: Type

Type de value à convertir.

context: JsonSerializerContext

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

Exceptions

ArgumentException

inputType n'est pas compatible avec value.

ArgumentNullException

utf8Json, inputType ou context est null.

NotSupportedException

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

S’applique à

Serialize(Stream, Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)

Paramètres

utf8Json: Stream

UTF-8 Stream dans lequel écrire.

value: Object

Valeur à convertir.

inputType: Type

Type de value à convertir.

options: JsonSerializerOptions

Options pour contrôler le comportement de conversion.

Exceptions

ArgumentException

inputType n'est pas compatible avec value.

ArgumentNullException

utf8Json ou inputType est null.

NotSupportedException

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

S’applique à

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

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

Public Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)

Paramètres

writer: Utf8JsonWriter

Rédacteur à écrire.

value: Object

Valeur à convertir et à écrire.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Exceptions

ArgumentNullException

writer ou jsonTypeInfo est null.

InvalidCastException

value ne correspond pas au type de jsonTypeInfo.

S’applique à

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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 de value à convertir.

options: JsonSerializerOptions

Options pour contrôler le comportement de sérialisation.

Exceptions

ArgumentException

inputType n’est pas compatible avec value.

ArgumentNullException

writer ou inputType est null.

NotSupportedException

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

Remarques

JsonWriterOptions utilisé pour créer le instance de la Utf8JsonWriter priorité sur le en cas de JsonSerializerOptions 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(Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

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

Public Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String

Public Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String

Paramètres

value: Object

Valeur à convertir.

inputType: Type

Type de value à convertir.

options: JsonSerializerOptions

Options pour contrôler le comportement de conversion.

Retours

String

Représentation sous forme de chaîne JSON de la valeur.

Exceptions

ArgumentException

inputType n'est pas compatible avec value.

ArgumentNullException

inputType a la valeur null.

NotSupportedException

Il n’existe pas de 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. Consultez également 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)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .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 -> unit

Public Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)

Paramètres

utf8Json: Stream

UTF-8 Stream dans lequel écrire.

value: Object

La valeur à convertir.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Exceptions

ArgumentNullException

utf8Json a la valeur null.

InvalidCastException

value ne correspond pas au type de jsonTypeInfo.

S’applique à

Serialize(Object, JsonTypeInfo)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

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

Public Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String

Paramètres

value: Object

La valeur à convertir.

jsonTypeInfo: JsonTypeInfo

Métadonnées relatives au type à convertir.

Retours

String

Représentation String de la valeur.

Exceptions

ArgumentNullException

jsonTypeInfo a la valeur null.

InvalidCastException

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. Consultez également SerializeToUtf8Bytes(Object, JsonTypeInfo) et SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).

S’applique à

Serialize(Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

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

Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String

Paramètres

value: Object

Valeur à convertir.

inputType: Type

Type de value à convertir.

context: JsonSerializerContext

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

Retours

String

Représentation String de la valeur.

Exceptions

NotSupportedException

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

InvalidOperationException

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

ArgumentNullException

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. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) Consultez également et SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

S’applique à

Serialize<TValue>(TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

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

Public Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

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

String

Représentation sous forme de chaîne JSON de la valeur.

Exceptions

NotSupportedException

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

Remarques

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

S’applique à

Serialize<TValue>(TValue, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

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

Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String

Paramètres de type

TValue

Type de la valeur à sérialiser.

Paramètres

value: TValue

La valeur à convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Retours

String

Représentation String de la valeur.

Exceptions

NotSupportedException

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

ArgumentNullException

jsonTypeInfo a la valeur 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. Consultez également SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) et SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).

S’applique à

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .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 -> unit

Public 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

utf8Json: Stream

UTF-8 Stream dans lequel écrire.

value: TValue

Valeur à convertir.

options: JsonSerializerOptions

Options pour contrôler le comportement de conversion.

Exceptions

ArgumentNullException

utf8Json a la valeur null.

NotSupportedException

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

S’applique à

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

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Convertit la valeur fournie en texte JSON encodé en UTF-8 et l’écrit dans .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> -> unit

Public 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

utf8Json: Stream

UTF-8 Stream dans lequel écrire.

value: TValue

La valeur à convertir.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Exceptions

ArgumentNullException

utf8Json a la valeur null.

NotSupportedException

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

S’applique à

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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

ArgumentNullException

writer a la valeur null.

NotSupportedException

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

Remarques

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

S’applique à

Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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

Rédacteur à écrire.

value: TValue

Valeur à convertir et à écrire.

jsonTypeInfo: JsonTypeInfo<TValue>

Métadonnées relatives au type à convertir.

Exceptions

ArgumentNullException

writer ou jsonTypeInfo est null.

NotSupportedException

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

S’applique à