JsonSerializer.Serialize Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Text.Json

Assembly:: System.Text.Json.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.
Serialize(Stream, Object, Type, JsonSerializerContext)	Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in Stream.
Serialize(Stream, Object, Type, JsonSerializerOptions)	Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in Stream.
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	Scrive la rappresentazione JSON del tipo specificato nel writer disponibile.
Serialize(Object, Type, JsonSerializerOptions)	Converte il valore di un tipo specificato in una stringa JSON.
Serialize(Stream, Object, JsonTypeInfo)	Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in Stream.
Serialize(Object, JsonTypeInfo)	Converte il valore fornito in un oggetto String.
Serialize(Object, Type, JsonSerializerContext)	Converte il valore fornito in un oggetto String.
Serialize<TValue>(TValue, JsonSerializerOptions)	Converte il valore di un tipo specificato da un parametro di tipo generico in una stringa JSON.
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)	Converte il valore fornito in un oggetto String.
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)	Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in Stream.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in Stream.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)	Scrive la rappresentazione JSON di un tipo specificato da un parametro di tipo generico nel writer disponibile.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.

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)

Parametri

writer: Utf8JsonWriter

Writer JSON in cui scrivere.

value: Object

Valore da convertire e scrivere.

inputType: Type

Tipo di value da convertire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Eccezioni

ArgumentException

inputType non è compatibile con value.

ArgumentNullException

writer o inputType è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

Si applica a

Serialize(Stream, Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in 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)

Parametri

utf8Json: Stream

UTF-8 Stream in cui scrivere.

value: Object

Valore da convertire.

inputType: Type

Tipo di value da convertire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Eccezioni

ArgumentException

inputType non è compatibile con value.

ArgumentNullException

utf8Json, inputType o context è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

Si applica a

Serialize(Stream, Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in 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)

Parametri

utf8Json: Stream

UTF-8 Stream in cui scrivere.

value: Object

Valore da convertire.

inputType: Type

Tipo di value da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di conversione.

Eccezioni

ArgumentException

inputType non è compatibile con value.

ArgumentNullException

utf8Json o inputType è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

Si applica a

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.

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)

Parametri

writer: Utf8JsonWriter

Writer da scrivere.

value: Object

Valore da convertire e scrivere.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Eccezioni

ArgumentNullException

writer o jsonTypeInfo è null.

InvalidCastException

value non corrisponde al tipo di jsonTypeInfo.

Si applica a

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Scrive la rappresentazione JSON del tipo specificato nel writer disponibile.

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)

Parametri

writer: Utf8JsonWriter

Writer JSON in cui scrivere.

value: Object

Valore da convertire e scrivere.

inputType: Type

Tipo di value da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di serializzazione.

Eccezioni

ArgumentException

inputType non è compatibile con value

ArgumentNullException

writer o inputType è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

Commenti

Oggetto JsonWriterOptions utilizzato per creare l'istanza di ha Utf8JsonWriter la precedenza sull'oggetto JsonSerializerOptions quando sono in conflitto. Di conseguenza, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidatione JsonWriterOptions.Encoder vengono usati durante la scrittura.

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

Serialize(Object, Type, JsonSerializerOptions)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Converte il valore di un tipo specificato in una stringa 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

Parametri

value: Object

Valore da convertire.

inputType: Type

Tipo di value da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di conversione.

Restituisce

String

Rappresentazione della stringa JSON del valore.

Eccezioni

ArgumentException

inputType non è compatibile con value.

ArgumentNullException

inputType è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

Commenti

L'uso di un String oggetto non è altrettanto efficiente come l'uso della codifica UTF-8 perché l'implementazione usa internamente UTF-8. Vedere anche SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) e SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

Serialize(Stream, Object, JsonTypeInfo)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in 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)

Parametri

utf8Json: Stream

UTF-8 Stream in cui scrivere.

value: Object

Valore da convertire.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Eccezioni

ArgumentNullException

utf8Json è null.

InvalidCastException

value non corrisponde al tipo di jsonTypeInfo.

Si applica a

Serialize(Object, JsonTypeInfo)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Converte il valore fornito in un oggetto 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

Parametri

value: Object

Valore da convertire.

jsonTypeInfo: JsonTypeInfo

Metadati relativi al tipo da convertire.

Restituisce

String

Rappresentazione String del valore.

Eccezioni

ArgumentNullException

jsonTypeInfo è null.

InvalidCastException

value non corrisponde al tipo di jsonTypeInfo.

Commenti

L'uso di un String oggetto non è altrettanto efficiente come l'uso della codifica UTF-8 perché l'implementazione usa internamente UTF-8. Vedere anche SerializeToUtf8Bytes(Object, JsonTypeInfo) e SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).

Si applica a

Serialize(Object, Type, JsonSerializerContext)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Converte il valore fornito in un oggetto 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

Parametri

value: Object

Valore da convertire.

inputType: Type

Tipo di value da convertire.

context: JsonSerializerContext

Provider di metadati per i tipi serializzabili.

Restituisce

String

Rappresentazione String del valore.

Eccezioni

NotSupportedException

Non sono presenti JsonConverter compatibili per inputType o i membri serializzabili.

InvalidOperationException

Metodo GetTypeInfo(Type) dei valori restituiti null forniti context per il tipo da convertire.

ArgumentNullException

inputType o context è null.

Commenti

L'uso di un String oggetto non è altrettanto efficiente come l'uso della codifica UTF-8, poiché l'implementazione usa internamente UTF-8. Vedere SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) anche e SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

Si applica a

Serialize<TValue>(TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Converte il valore di un tipo specificato da un parametro di tipo generico in una stringa 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

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

value: TValue

Valore da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di serializzazione.

Restituisce

String

Rappresentazione della stringa JSON del valore.

Eccezioni

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

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

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Source:: JsonSerializer.Write.String.cs

Converte il valore fornito in un oggetto 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

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

value: TValue

Valore da convertire.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Restituisce

String

Rappresentazione String del valore.

Eccezioni

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

ArgumentNullException

jsonTypeInfo è null.

Commenti

L'uso di un String oggetto non è altrettanto efficiente come l'uso della codifica UTF-8 perché l'implementazione usa internamente UTF-8. Vedere anche SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) e SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).

Si applica a

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in 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)

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json: Stream

UTF-8 Stream in cui scrivere.

value: TValue

Valore da convertire.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di conversione.

Eccezioni

ArgumentNullException

utf8Json è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

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

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Source:: JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive in 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))

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json: Stream

UTF-8 Stream in cui scrivere.

value: TValue

Valore da convertire.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Eccezioni

ArgumentNullException

utf8Json è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Scrive la rappresentazione JSON di un tipo specificato da un parametro di tipo generico nel writer disponibile.

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)

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

writer: Utf8JsonWriter

Writer JSON in cui scrivere.

value: TValue

Valore da convertire e scrivere.

options: JsonSerializerOptions

Opzioni per controllare il comportamento di serializzazione.

Eccezioni

ArgumentNullException

writer è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

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

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Source:: JsonSerializer.Write.Utf8JsonWriter.cs

Scrive un valore JSON (inclusi gli oggetti o le matrici) nel writer specificato.

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

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

writer: Utf8JsonWriter

Writer da scrivere.

value: TValue

Valore da convertire e scrivere.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadati relativi al tipo da convertire.

Eccezioni

ArgumentNullException

writer o jsonTypeInfo è null.

NotSupportedException

Non sono presenti JsonConverter compatibili per TValue o i membri serializzabili.

Si applica a