JsonSerializer.Serialize Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v11.0.0-preview.5.26302.115

Přetížení

Name	Description
Serialize(Object, JsonTypeInfo)	Převede zadanou Stringhodnotu na hodnotu .
Serialize(Stream, Object, JsonTypeInfo)	Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ho Streamdo souboru .
Serialize(Object, Type, JsonSerializerOptions)	Převede hodnotu zadaného typu na řetězec JSON.
Serialize(Object, Type, JsonSerializerContext)	Převede zadanou Stringhodnotu na hodnotu .
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 ho Streamdo souboru .
Serialize(Stream, Object, Type, JsonSerializerContext)	Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ho Streamdo souboru .
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Zapisuje do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)	Zapíše reprezentaci JSON typu určeného parametrem obecného typu do zadaného zapisovače.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ho Streamdo souboru .
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 Stringhodnotu na hodnotu .
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)	Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ho Streamdo souboru .

Serialize(Object, JsonTypeInfo)

Zdroj:

JsonSerializer.Write.String.cs

Převede zadanou Stringhodnotu na hodnotu .

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

Reprezentace String hodnoty.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

InvalidCastException

valueneodpovídá typu .jsonTypeInfo

Poznámky

String Použití 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(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 ho Streamdo souboru .

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 pro zápis.

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

valueneodpovídá typu .jsonTypeInfo

Serialize(Object, Type, JsonSerializerOptions)

Zdroj:

JsonSerializer.Write.String.cs

Převede hodnotu zadaného typu na řetězec JSON.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static string Serialize(object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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 převodu value .

options

JsonSerializerOptions

Možnosti pro řízení chování převodu

Návraty

String

Řetězcová reprezentace json hodnoty.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

inputType je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

Poznámky

String Použití 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(Object, Type, JsonSerializerContext)

Zdroj:

JsonSerializer.Write.String.cs

Převede zadanou Stringhodnotu na hodnotu .

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 převodu value .

context

JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

String

Reprezentace String hodnoty.

Výjimky

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

InvalidOperationException

Metoda GetTypeInfo(Type) zadaného context návratu null pro typ, který se má převést.

ArgumentNullException

inputType nebo context je null.

Poznámky

String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) Viz a SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

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

valueneodpoví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 ho Streamdo souboru .

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize(System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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 pro zápis.

value

Object

Hodnota, kterou chcete převést.

inputType

Type

Typ převodu value .

options

JsonSerializerOptions

Možnosti pro řízení chování převodu

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

utf8Json nebo inputType je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

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 ho Streamdo souboru .

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 pro zápis.

value

Object

Hodnota, kterou chcete převést.

inputType

Type

Typ převodu value .

context

JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Výjimky

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

utf8Json, inputTypenebo context je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Zdroj:

JsonSerializer.Write.Utf8JsonWriter.cs

Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize(System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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 převodu value .

options

JsonSerializerOptions

Možnosti řízení chování serializace

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

ArgumentException

inputType není kompatibilní s value

ArgumentNullException

writer nebo inputType je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

Poznámky

Použitý JsonWriterOptions k vytvoření instance Utf8JsonWriter má přednost před konfliktem JsonSerializerOptions . Proto se JsonWriterOptions.IndentedJsonWriterOptions.SkipValidationpři psaní používají a JsonWriterOptions.Encoder používají se.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

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 převodu value .

context

JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Výjimky

ArgumentException

inputType není kompatibilní s value.

ArgumentNullException

writer nebo inputType je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterinputType .

InvalidOperationException

Metoda GetTypeInfo(Type) zadaného context návratu null pro typ, který se má převést.

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

Pro serializovatelné členy není kompatibilní JsonConverterTValue .

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.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize<TValue>(System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

writer je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterTValue .

Poznámky

Použitý JsonWriterOptions k vytvoření instance Utf8JsonWriter má přednost před konfliktem JsonSerializerOptions . Proto se JsonWriterOptions.IndentedJsonWriterOptions.SkipValidationpři psaní používají a JsonWriterOptions.Encoder používají se.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

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 ho Streamdo souboru .

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 pro zápis.

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

Pro serializovatelné členy není kompatibilní JsonConverterTValue .

Serialize<TValue>(TValue, JsonSerializerOptions)

Zdroj:

JsonSerializer.Write.String.cs

Převede hodnotu typu určeného parametrem obecného typu na řetězec JSON.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static string Serialize<TValue>(TValue value, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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.

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterTValue .

Poznámky

String Použití 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 Stringhodnotu na hodnotu .

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

Reprezentace String hodnoty.

Výjimky

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterTValue .

ArgumentNullException

jsonTypeInfo je null.

Poznámky

String Použití 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 ho Streamdo souboru .

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize<TValue>(System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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 pro zápis.

value

TValue

Hodnota, kterou chcete převést.

options

JsonSerializerOptions

Možnosti pro řízení chování převodu

Atributy

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

utf8Json je null.

NotSupportedException

Pro serializovatelné členy není kompatibilní JsonConverterTValue .