Sdílet prostřednictvím


JsonSerializer.Serialize Metoda

Definice

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)

Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs

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

utf8Json
Stream

UTF-8 Stream k zápisu.

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, inputTypenebo context je null.

Není kompatibilní JsonConverter pro inputType nebo jeho serializovatelné členy.

Platí pro

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs

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)

Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs

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)

Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs

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)

Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs

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

utf8Json
Stream

UTF-8 Stream k zápisu.

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)

Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs

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)

Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs

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

utf8Json
Stream

UTF-8 Stream k zápisu.

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)

Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs

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)

Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs

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)

Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs

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)

Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs

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

Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs
Zdroj:
JsonSerializer.Write.String.cs

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)

Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs

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

utf8Json
Stream

UTF-8 Stream k zápisu.

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

Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs
Zdroj:
JsonSerializer.Write.Stream.cs

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

utf8Json
Stream

UTF-8 Stream k zápisu.

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

Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs
Zdroj:
JsonSerializer.Write.Utf8JsonWriter.cs

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.

Platí pro