JsonSerializer.Serialize Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Serialize(Stream, Object, Type, JsonSerializerContext) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no Stream. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Grava a representação JSON do tipo especificado no gravador fornecido. |
| Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido. |
| Serialize(Stream, Object, Type, JsonSerializerOptions) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no Stream. |
| Serialize(Object, Type, JsonSerializerOptions) |
Converte o valor de um tipo especificado em uma cadeia de caracteres JSON. |
| Serialize(Stream, Object, JsonTypeInfo) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no Stream. |
| Serialize(Object, JsonTypeInfo) |
Converte o valor fornecido em um String. |
| Serialize(Object, Type, JsonSerializerContext) |
Converte o valor fornecido em um String. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Grava a representação JSON de um tipo especificado por um parâmetro de tipo genérico no gravador fornecido. |
| Serialize<TValue>(TValue, JsonSerializerOptions) |
Converte o valor de um tipo especificado por um parâmetro de tipo genérico em uma cadeia de caracteres JSON. |
| Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Converte o valor fornecido em um String. |
| Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no Stream. |
| Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no Stream. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido. |
Serialize(Stream, Object, Type, JsonSerializerContext)
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no 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)Parâmetros
- value
- Object
O valor a ser convertido.
- inputType
- Type
O tipo do value a ser convertido.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Exceções
inputType não é compatível com value.
utf8Json, inputTypeou context é null.
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
Aplica-se a
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido.
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)Parâmetros
- writer
- Utf8JsonWriter
Um gravador JSON para escrever.
- value
- Object
O valor a ser convertido e gravado.
- inputType
- Type
O tipo do value a ser convertido.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Exceções
inputType não é compatível com value.
writer ou inputType é null.
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
O método GetTypeInfo(Type) do context fornecido retorna null para o tipo a ser convertido.
Aplica-se a
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Grava a representação JSON do tipo especificado no gravador fornecido.
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)Parâmetros
- writer
- Utf8JsonWriter
O gravador JSON para o qual escrever.
- value
- Object
O valor a ser convertido e gravado.
- inputType
- Type
O tipo do value a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de serialização.
Exceções
inputType não é compatível com value
writer ou inputType é null.
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
Comentários
Os JsonWriterOptions usados para criar a instância do Utf8JsonWriter têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidatione JsonWriterOptions.Encoder são usados durante a gravação.
Para obter mais informações, consulte Como serializar e desserializarJSON.
Aplica-se a
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido.
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)Parâmetros
- writer
- Utf8JsonWriter
O gravador a ser escrito.
- value
- Object
O valor a ser convertido e gravado.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a ser convertido.
Exceções
writer ou jsonTypeInfo é null.
value não corresponde ao tipo de jsonTypeInfo.
Aplica-se a
Serialize(Stream, Object, Type, JsonSerializerOptions)
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no 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)Parâmetros
- value
- Object
O valor a ser convertido.
- inputType
- Type
O tipo do value a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de conversão.
Exceções
inputType não é compatível com value.
utf8Json ou inputType é null.
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
Aplica-se a
Serialize(Object, Type, JsonSerializerOptions)
Converte o valor de um tipo especificado em uma cadeia de caracteres 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 StringParâmetros
- value
- Object
O valor a ser convertido.
- inputType
- Type
O tipo do value a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de conversão.
Retornos
A representação da cadeia de caracteres JSON do valor.
Exceções
inputType não é compatível com value.
inputType é null.
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
Comentários
Usar um String não é tão eficiente quanto usar a codificação UTF-8, pois a implementação usa internamente UTF-8. Consulte também SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) e SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Para obter mais informações, consulte Como serializar e desserializarJSON.
Aplica-se a
Serialize(Stream, Object, JsonTypeInfo)
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no 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)Parâmetros
- value
- Object
O valor a ser convertido.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a ser convertido.
Exceções
utf8Json é null.
value não corresponde ao tipo de jsonTypeInfo.
Aplica-se a
Serialize(Object, JsonTypeInfo)
Converte o valor fornecido em um 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 StringParâmetros
- value
- Object
O valor a ser convertido.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação String do valor.
Exceções
jsonTypeInfo é null.
value não corresponde ao tipo de jsonTypeInfo.
Comentários
Usar um String não é tão eficiente quanto usar a codificação UTF-8, pois a implementação usa internamente UTF-8. Consulte também SerializeToUtf8Bytes(Object, JsonTypeInfo) e SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Aplica-se a
Serialize(Object, Type, JsonSerializerContext)
Converte o valor fornecido em um 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 StringParâmetros
- value
- Object
O valor a ser convertido.
- inputType
- Type
O tipo do value a ser convertido.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação String do valor.
Exceções
Não há JsonConverter compatíveis para inputType ou seus membros serializáveis.
O método GetTypeInfo(Type) do context fornecido retorna null para o tipo a ser convertido.
inputType ou context é null.
Comentários
Usar um String não é tão eficiente quanto usar a codificação UTF-8, pois a implementação usa internamente UTF-8. Consulte também SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) e SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Aplica-se a
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Grava a representação JSON de um tipo especificado por um parâmetro de tipo genérico no gravador fornecido.
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)Parâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- writer
- Utf8JsonWriter
Um gravador JSON para escrever.
- value
- TValue
O valor a ser convertido e gravado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de serialização.
Exceções
writer é null.
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
Comentários
Os JsonWriterOptions usados para criar a instância do Utf8JsonWriter têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidatione JsonWriterOptions.Encoder são usados durante a gravação.
Para obter mais informações, consulte Como serializar e desserializarJSON.
Aplica-se a
Serialize<TValue>(TValue, JsonSerializerOptions)
Converte o valor de um tipo especificado por um parâmetro de tipo genérico em uma cadeia de caracteres 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 StringParâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- value
- TValue
O valor a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de serialização.
Retornos
Uma representação de cadeia de caracteres JSON do valor.
Exceções
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
Comentários
Usar um String não é tão eficiente quanto usar a codificação UTF-8, pois a implementação usa internamente UTF-8. Consulte também SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) e SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Para obter mais informações, consulte Como serializar e desserializarJSON.
Aplica-se a
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Converte o valor fornecido em um 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 StringParâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- value
- TValue
O valor a ser convertido.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação String do valor.
Exceções
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
jsonTypeInfo é null.
Comentários
Usar um String não é tão eficiente quanto usar a codificação UTF-8, pois a implementação usa internamente UTF-8. Consulte também SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) e SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Aplica-se a
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no 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)Parâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- value
- TValue
O valor a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de conversão.
Exceções
utf8Json é null.
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
Aplica-se a
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Converte o valor fornecido em texto JSON codificado em UTF-8 e grava-o no 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))Parâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- value
- TValue
O valor a ser convertido.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Exceções
utf8Json é null.
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
Aplica-se a
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Grava um valor JSON (incluindo objetos ou matrizes) no gravador fornecido.
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))Parâmetros de tipo
- TValue
O tipo do valor a ser serializado.
Parâmetros
- writer
- Utf8JsonWriter
O gravador a ser escrito.
- value
- TValue
O valor a ser convertido e gravado.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Exceções
writer ou jsonTypeInfo é null.
Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.
