JsonSerializer.Serialize Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado. |
Serialize(Stream, Object, Type, JsonSerializerContext) |
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .Stream |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .Stream |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Escribe la representación JSON del tipo especificado en el sistema de escritura proporcionado. |
Serialize(Object, Type, JsonSerializerOptions) |
Convierte el valor de un tipo especificado en una cadena JSON. |
Serialize(Stream, Object, JsonTypeInfo) |
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .Stream |
Serialize(Object, JsonTypeInfo) |
Convierte el valor proporcionado en .String |
Serialize(Object, Type, JsonSerializerContext) |
Convierte el valor proporcionado en .String |
Serialize<TValue>(TValue, JsonSerializerOptions) |
Convierte el valor de un tipo especificado por un parámetro de tipo genérico en una cadena JSON. |
Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Convierte el valor proporcionado en .String |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .Stream |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .Stream |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Escribe la representación JSON de un tipo especificado por un parámetro de tipo genérico en el sistema de escritura proporcionado. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado.
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)
Parámetros
- writer
- Utf8JsonWriter
Un sistema de escritura JSON en el que se va a escribir.
- value
- Object
Valor que se va a convertir y leer.
- inputType
- Type
Tipo de value
que se va a convertir.
- context
- JsonSerializerContext
Proveedor de metadatos para tipos serializables.
Excepciones
inputType
no es compatible con value
.
writer
o inputType
es null
.
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
El GetTypeInfo(Type) método del objeto proporcionado context
devuelve null
para el tipo que se va a convertir.
Se aplica a
Serialize(Stream, Object, Type, JsonSerializerContext)
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .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)
Parámetros
- value
- Object
Valor que se va a convertir.
- inputType
- Type
Tipo de value
que se va a convertir.
- context
- JsonSerializerContext
Proveedor de metadatos para tipos serializables.
Excepciones
inputType
no es compatible con value
.
utf8Json
, inputType
o context
es null
.
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
Se aplica a
Serialize(Stream, Object, Type, JsonSerializerOptions)
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .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)
Parámetros
- value
- Object
Valor que se va a convertir.
- inputType
- Type
Tipo de value
que se va a convertir.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la conversión.
Excepciones
inputType
no es compatible con value
.
utf8Json
o inputType
es null
.
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
Se aplica a
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado.
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)
Parámetros
- writer
- Utf8JsonWriter
Escritor que se va a escribir.
- value
- Object
Valor que se va a convertir y leer.
- jsonTypeInfo
- JsonTypeInfo
Metadatos sobre el tipo que se va a convertir.
Excepciones
writer
o jsonTypeInfo
es null
.
value
no coincide con el tipo de jsonTypeInfo
.
Se aplica a
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Escribe la representación JSON del tipo especificado en el sistema de escritura proporcionado.
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)
Parámetros
- writer
- Utf8JsonWriter
Sistema de escritura JSON en el que se va a escribir.
- value
- Object
Valor que se va a convertir y leer.
- inputType
- Type
Tipo de value
que se va a convertir.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la serialización.
Excepciones
inputType
no es compatible con value
.
writer
o inputType
es null
.
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
Comentarios
que JsonWriterOptions se usa para crear la instancia de tiene Utf8JsonWriter prioridad sobre el JsonSerializerOptions momento en que entran en conflicto. Por lo tanto, JsonWriterOptions.IndentedJsonWriterOptions.SkipValidation, y JsonWriterOptions.Encoder se usan al escribir.
Para obtener más información, consulte Cómo serializar y deserializar JSON.
Se aplica a
Serialize(Object, Type, JsonSerializerOptions)
Convierte el valor de un tipo especificado en una cadena 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
Parámetros
- value
- Object
Valor que se va a convertir.
- inputType
- Type
Tipo de value
que se va a convertir.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la conversión.
Devoluciones
Representación de cadena JSON del valor.
Excepciones
inputType
no es compatible con value
.
inputType
es null
.
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
Comentarios
El uso de no String es tan eficaz como el uso de codificación UTF-8, ya que la implementación usa internamente UTF-8. Vea también SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) y SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Para obtener más información, consulte Cómo serializar y deserializar JSON.
Se aplica a
Serialize(Stream, Object, JsonTypeInfo)
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .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)
Parámetros
- value
- Object
Valor que se va a convertir.
- jsonTypeInfo
- JsonTypeInfo
Metadatos sobre el tipo que se va a convertir.
Excepciones
utf8Json
es null
.
value
no coincide con el tipo de jsonTypeInfo
.
Se aplica a
Serialize(Object, JsonTypeInfo)
Convierte el valor proporcionado 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
Parámetros
- value
- Object
Valor que se va a convertir.
- jsonTypeInfo
- JsonTypeInfo
Metadatos sobre el tipo que se va a convertir.
Devoluciones
Representación String del valor.
Excepciones
jsonTypeInfo
es null
.
value
no coincide con el tipo de jsonTypeInfo
.
Comentarios
El uso de no String es tan eficaz como el uso de codificación UTF-8, ya que la implementación usa internamente UTF-8. Vea también SerializeToUtf8Bytes(Object, JsonTypeInfo) y SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Se aplica a
Serialize(Object, Type, JsonSerializerContext)
Convierte el valor proporcionado 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
Parámetros
- value
- Object
Valor que se va a convertir.
- inputType
- Type
Tipo de value
que se va a convertir.
- context
- JsonSerializerContext
Proveedor de metadatos para tipos serializables.
Devoluciones
Representación String del valor.
Excepciones
No hay ningún JsonConverter compatible para inputType
o sus miembros serializables.
El GetTypeInfo(Type) método del objeto proporcionado context
devuelve null
para el tipo que se va a convertir.
inputType
o context
es null
.
Comentarios
El uso de no String es tan eficaz como el uso de codificación UTF-8, ya que la implementación usa internamente UTF-8. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) Vea también y SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Se aplica a
Serialize<TValue>(TValue, JsonSerializerOptions)
Convierte el valor de un tipo especificado por un parámetro de tipo genérico en una cadena 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
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- value
- TValue
Valor que se va a convertir.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la serialización.
Devoluciones
Una representación de cadena JSON del valor.
Excepciones
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
Comentarios
El uso de no String es tan eficaz como el uso de codificación UTF-8, ya que la implementación usa internamente UTF-8. Vea también SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) y SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Para obtener más información, consulte Cómo serializar y deserializar JSON.
Se aplica a
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Convierte el valor proporcionado 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
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- value
- TValue
Valor que se va a convertir.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadatos sobre el tipo que se va a convertir.
Devoluciones
Representación String del valor.
Excepciones
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
jsonTypeInfo
es null
.
Comentarios
El uso de no String es tan eficaz como el uso de codificación UTF-8, ya que la implementación usa internamente UTF-8. Vea también SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) y SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Se aplica a
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .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)
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- value
- TValue
Valor que se va a convertir.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la conversión.
Excepciones
utf8Json
es null
.
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
Se aplica a
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Convierte el valor proporcionado en texto JSON codificado UTF-8 y lo escribe en .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))
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- value
- TValue
Valor que se va a convertir.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadatos sobre el tipo que se va a convertir.
Excepciones
utf8Json
es null
.
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
Se aplica a
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Escribe la representación JSON de un tipo especificado por un parámetro de tipo genérico en el sistema de escritura proporcionado.
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)
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- writer
- Utf8JsonWriter
Un sistema de escritura JSON en el que se va a escribir.
- value
- TValue
Valor que se va a convertir y leer.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento de la serialización.
Excepciones
writer
es null
.
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
Comentarios
que JsonWriterOptions se usa para crear la instancia de tiene Utf8JsonWriter prioridad sobre el JsonSerializerOptions momento en que entran en conflicto. Por lo tanto, JsonWriterOptions.IndentedJsonWriterOptions.SkipValidation, y JsonWriterOptions.Encoder se usan al escribir.
Para obtener más información, consulte Cómo serializar y deserializar JSON.
Se aplica a
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Escribe un valor JSON (incluidos objetos o matrices) en el escritor proporcionado.
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))
Parámetros de tipo
- TValue
Tipo del valor que se va a serializar.
Parámetros
- writer
- Utf8JsonWriter
Escritor que se va a escribir.
- value
- TValue
Valor que se va a convertir y leer.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadatos sobre el tipo que se va a convertir.
Excepciones
writer
o jsonTypeInfo
es null
.
No hay ningún JsonConverter compatible para TValue
o sus miembros serializables.
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de