JsonSerializer.Serialize Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

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

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

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

utf8Json, inputTypenebo context je null.

NotSupportedException

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

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

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

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

writer nebo inputType je null.

NotSupportedException

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

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

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

static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

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

ArgumentException

inputType není kompatibilní s value

ArgumentNullException

writer nebo inputType je null.

NotSupportedException

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.

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

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

ArgumentNullException

writer nebo jsonTypeInfo je null.

InvalidCastException

value neodpovídá typu jsonTypeInfo.

Serialize(Stream, Object, Type, JsonSerializerOptions)

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

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

utf8Json nebo inputType je null.

NotSupportedException

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

Serialize(Object, Type, JsonSerializerOptions)

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

static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> 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

String

Řetězcová reprezentace json hodnoty.

Výjimky

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

inputType je null.

NotSupportedException

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.

Serialize(Stream, Object, JsonTypeInfo)

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

ArgumentNullException

utf8Json je null.

InvalidCastException

value neodpovídá typu jsonTypeInfo.

Serialize(Object, JsonTypeInfo)

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

String

A String reprezentace hodnoty.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

InvalidCastException

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

Serialize(Object, Type, JsonSerializerContext)

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

String

A String reprezentace hodnoty.

Výjimky

NotSupportedException

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

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

ArgumentNullException

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

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

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

static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unit

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

ArgumentNullException

writer je null.

NotSupportedException

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.

Serialize<TValue>(TValue, JsonSerializerOptions)

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

static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> 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

String

Řetězcové vyjádření hodnoty VE FORMÁTU JSON.

Výjimky

NotSupportedException

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.

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

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

String

A String reprezentace hodnoty.

Výjimky

NotSupportedException

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

ArgumentNullException

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

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

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

ArgumentNullException

utf8Json je null.

NotSupportedException

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

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

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

ArgumentNullException

utf8Json je null.

NotSupportedException

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

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

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

ArgumentNullException

writer nebo jsonTypeInfo je null.

NotSupportedException

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