JsonSerializer.Serialize Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
Serialize(Stream, Object, Type, JsonSerializerContext) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do Stream. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí). |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače. |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí). |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do Stream. |
Serialize(Object, Type, JsonSerializerOptions) |
Převede hodnotu zadaného typu na řetězec JSON. |
Serialize(Stream, Object, JsonTypeInfo) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do Stream. |
Serialize(Object, JsonTypeInfo) |
Převede zadanou hodnotu na String. |
Serialize(Object, Type, JsonSerializerContext) |
Převede zadanou hodnotu na String. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Zapíše reprezentaci JSON typu určeného parametrem obecného typu do zadaného zapisovače. |
Serialize<TValue>(TValue, JsonSerializerOptions) |
Převede hodnotu typu určeného parametrem obecného typu na řetězec JSON. |
Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Převede zadanou hodnotu na String. |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do Stream. |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do Stream. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí). |
Serialize(Stream, Object, Type, JsonSerializerContext)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
, který chcete převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Výjimky
inputType
není kompatibilní s value
.
utf8Json
, inputType
nebo context
je null
.
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Platí pro
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
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)
Parametry
- writer
- Utf8JsonWriter
Zapisovatel JSON, do který se má zapisovat.
- value
- Object
Hodnota pro převod a zápis.
- inputType
- Type
Typ value
, který chcete převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Výjimky
inputType
není kompatibilní s value
.
writer
nebo inputType
je null
.
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Metoda GetTypeInfo(Type) poskytnutého context
vrátí null
pro typ, který se má převést.
Platí pro
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače.
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)
Parametry
- writer
- Utf8JsonWriter
Zapisovač JSON, do který se má zapisovat.
- value
- Object
Hodnota pro převod a zápis.
- inputType
- Type
Typ value
, který chcete převést.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace
Výjimky
inputType
není kompatibilní s value
writer
nebo inputType
je null
.
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Poznámky
JsonWriterOptions sloužící k vytvoření instance Utf8JsonWriter mají přednost před JsonSerializerOptions v případě konfliktu. Proto se při psaní používají JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationa JsonWriterOptions.Encoder.
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
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)
Parametry
- writer
- Utf8JsonWriter
Zapisovač, který se má psát.
- value
- Object
Hodnota pro převod a zápis.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který chcete převést.
Výjimky
writer
nebo jsonTypeInfo
je null
.
value
neodpovídá typu jsonTypeInfo
.
Platí pro
Serialize(Stream, Object, Type, JsonSerializerOptions)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
, který chcete převést.
- options
- JsonSerializerOptions
Možnosti pro řízení chování převodu
Výjimky
inputType
není kompatibilní s value
.
utf8Json
nebo inputType
je null
.
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Platí pro
Serialize(Object, Type, JsonSerializerOptions)
Převede hodnotu zadaného typu na řetězec 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
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
, který chcete převést.
- options
- JsonSerializerOptions
Možnosti pro řízení chování převodu
Návraty
Řetězcová reprezentace json hodnoty.
Výjimky
inputType
není kompatibilní s value
.
inputType
je null
.
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Poznámky
Použití String není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) a SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize(Stream, Object, JsonTypeInfo)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který chcete převést.
Výjimky
utf8Json
je null
.
value
neodpovídá typu jsonTypeInfo
.
Platí pro
Serialize(Object, JsonTypeInfo)
Převede zadanou hodnotu na 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
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který chcete převést.
Návraty
A String reprezentace hodnoty.
Výjimky
jsonTypeInfo
je null
.
value
neodpovídá typu jsonTypeInfo
.
Poznámky
Použití String není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, JsonTypeInfo) a SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Platí pro
Serialize(Object, Type, JsonSerializerContext)
Převede zadanou hodnotu na 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
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
, který chcete převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Návraty
A String reprezentace hodnoty.
Výjimky
Není kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Metoda GetTypeInfo(Type) poskytnutého context
vrátí null
pro typ, který se má převést.
inputType
nebo context
je null
.
Poznámky
Použití String není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) a SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Platí pro
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Zapíše reprezentaci JSON typu určeného parametrem obecného typu do zadaného zapisovače.
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)
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- writer
- Utf8JsonWriter
Zapisovatel JSON, do který se má zapisovat.
- value
- TValue
Hodnota pro převod a zápis.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace
Výjimky
writer
je null
.
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
Poznámky
JsonWriterOptions sloužící k vytvoření instance Utf8JsonWriter mají přednost před JsonSerializerOptions v případě konfliktu. Proto se při psaní používají JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationa JsonWriterOptions.Encoder.
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize<TValue>(TValue, JsonSerializerOptions)
Převede hodnotu typu určeného parametrem obecného typu na řetězec 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
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace
Návraty
Řetězcové vyjádření hodnoty VE FORMÁTU JSON.
Výjimky
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
Poznámky
Použití String není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) a SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Převede zadanou hodnotu na 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
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který chcete převést.
Návraty
A String reprezentace hodnoty.
Výjimky
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
jsonTypeInfo
je null
.
Poznámky
Použití String není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) a SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Platí pro
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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)
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- options
- JsonSerializerOptions
Možnosti pro řízení chování převodu
Výjimky
utf8Json
je null
.
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
Platí pro
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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))
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který chcete převést.
Výjimky
utf8Json
je null
.
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
Platí pro
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
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))
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- writer
- Utf8JsonWriter
Zapisovač, který se má psát.
- value
- TValue
Hodnota pro převod a zápis.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který chcete převést.
Výjimky
writer
nebo jsonTypeInfo
je null
.
Není kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.