JsonSerializer.Serialize Метод

Определение

Пространство имен:: System.Text.Json

Сборка:: System.Text.Json.dll

Пакет:: System.Text.Json v11.0.0-preview.5.26302.115

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

Имя	Описание
Serialize(Object, JsonTypeInfo)	Преобразует предоставленное значение в Stringобъект.
Serialize(Stream, Object, JsonTypeInfo)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.
Serialize(Object, Type, JsonSerializerOptions)	Преобразует значение указанного типа в строку JSON.
Serialize(Object, Type, JsonSerializerContext)	Преобразует предоставленное значение в Stringобъект.
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.
Serialize(Stream, Object, Type, JsonSerializerOptions)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.
Serialize(Stream, Object, Type, JsonSerializerContext)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	Записывает представление JSON указанного типа в предоставленный модуль записи.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)	Записывает представление JSON типа, указанного параметром универсального типа, в предоставленный модуль записи.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.
Serialize<TValue>(TValue, JsonSerializerOptions)	Преобразует значение типа, указанного параметром универсального типа, в строку JSON.
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)	Преобразует предоставленное значение в Stringобъект.
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.

Serialize(Object, JsonTypeInfo)

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Преобразует предоставленное значение в 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

Параметры

value: Object

Преобразуемое значение .

jsonTypeInfo: JsonTypeInfo

Метаданные о преобразуемом типе.

Возвращаемое значение

String

Представление String значения.

Исключения

ArgumentNullException

jsonTypeInfo равно null.

InvalidCastException

value не соответствует типу jsonTypeInfo.

Использование не String так эффективно, как использование кодировки UTF-8, так как реализация внутренне использует UTF-8. См. также SerializeToUtf8Bytes(Object, JsonTypeInfo) и SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).

Применяется к

Serialize(Stream, Object, JsonTypeInfo)

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в 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)

Параметры

utf8Json: Stream

UTF-8 Stream для записи.

value: Object

Преобразуемое значение .

jsonTypeInfo: JsonTypeInfo

Метаданные о преобразуемом типе.

Исключения

ArgumentNullException

utf8Json равно null.

InvalidCastException

value не соответствует типу jsonTypeInfo.

Применяется к

Serialize(Object, Type, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Преобразует значение указанного типа в строку 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);

public static string Serialize(object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

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

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

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

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

Public Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String

Параметры

value: Object

Преобразуемое значение .

inputType: Type

Тип преобразуемого value объекта.

options: JsonSerializerOptions

Параметры для управления поведением преобразования.

Возвращаемое значение

String

Строковое представление значения в формате JSON.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

ArgumentException

inputType несовместим с value.

ArgumentNullException

inputType равно null.

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

Использование не String так эффективно, как использование кодировки UTF-8, так как реализация внутренне использует UTF-8. См. также SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) и SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).

Дополнительные сведения см. в статье "Сериализация и десериализация JSON".

Применяется к

Serialize(Object, Type, JsonSerializerContext)

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Преобразует предоставленное значение в 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

Параметры

value: Object

Преобразуемое значение .

inputType: Type

Тип преобразуемого value объекта.

context: JsonSerializerContext

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

String

Представление String значения.

Исключения

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

InvalidOperationException

Метод GetTypeInfo(Type) предоставленного возвращаемого contextnull типа для преобразуемого типа.

ArgumentNullException

inputType или context есть null.

Использование не String так эффективно, как кодировка UTF-8, так как реализация внутренне использует UTF-8. Также см SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) . и SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

Применяется к

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.

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)

Параметры

writer: Utf8JsonWriter

Модуль записи.

value: Object

Значение для преобразования и записи.

jsonTypeInfo: JsonTypeInfo

Метаданные о преобразуемом типе.

Исключения

ArgumentNullException

writer или jsonTypeInfo есть null.

InvalidCastException

value не соответствует типу jsonTypeInfo.

Применяется к

Serialize(Stream, Object, Type, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.

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

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

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

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)

Параметры

utf8Json: Stream

UTF-8 Stream для записи.

value: Object

Преобразуемое значение .

inputType: Type

Тип преобразуемого value объекта.

options: JsonSerializerOptions

Параметры для управления поведением преобразования.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

ArgumentException

inputType несовместим с value.

ArgumentNullException

utf8Json или inputType есть null.

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

Применяется к

Serialize(Stream, Object, Type, JsonSerializerContext)

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в 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)

Параметры

utf8Json: Stream

UTF-8 Stream для записи.

value: Object

Преобразуемое значение .

inputType: Type

Тип преобразуемого value объекта.

context: JsonSerializerContext

Поставщик метаданных для сериализуемых типов.

Исключения

ArgumentException

inputType несовместим с value.

ArgumentNullException

utf8Json, или inputTypecontext есть null.

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

Применяется к

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Записывает представление 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 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);

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

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

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

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

Public Shared Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)

Параметры

writer: Utf8JsonWriter

Модуль записи JSON для записи.

value: Object

Значение для преобразования и записи.

inputType: Type

Тип преобразуемого value объекта.

options: JsonSerializerOptions

Параметры управления поведением сериализации.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

ArgumentException

inputType несовместим с value

ArgumentNullException

writer или inputType есть null.

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

Используется JsonWriterOptions для создания экземпляра приоритета Utf8JsonWriter над JsonSerializerOptions конфликтом. Следовательно, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationи JsonWriterOptions.Encoder используются при написании.

Дополнительные сведения см. в статье "Сериализация и десериализация JSON".

Применяется к

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.

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)

Параметры

writer: Utf8JsonWriter

Модуль записи JSON для записи.

value: Object

Значение для преобразования и записи.

inputType: Type

Тип преобразуемого value объекта.

context: JsonSerializerContext

Поставщик метаданных для сериализуемых типов.

Исключения

ArgumentException

inputType несовместим с value.

ArgumentNullException

writer или inputType есть null.

NotSupportedException

Нет совместимых JsonConverter элементов inputType или его сериализуемых элементов.

InvalidOperationException

Метод GetTypeInfo(Type) предоставленного возвращаемого contextnull типа для преобразуемого типа.

Применяется к

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

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Записывает одно значение JSON (включая объекты или массивы) в предоставленный модуль записи.

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

Параметры типа

TValue

Тип сериализации значения.

Параметры

writer: Utf8JsonWriter

Модуль записи.

value: TValue

Значение для преобразования и записи.

jsonTypeInfo: JsonTypeInfo<TValue>

Метаданные о преобразуемом типе.

Исключения

ArgumentNullException

writer или jsonTypeInfo есть null.

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

Применяется к

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Исходный код:: JsonSerializer.Write.Utf8JsonWriter.cs

Записывает представление 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 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);

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

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

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

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

Public Shared Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)

Параметры типа

TValue

Тип сериализации значения.

Параметры

writer: Utf8JsonWriter

Модуль записи JSON для записи.

value: TValue

Значение для преобразования и записи.

options: JsonSerializerOptions

Параметры управления поведением сериализации.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

writer равно null.

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

Применяется к

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

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в 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))

Параметры типа

TValue

Тип сериализации значения.

Параметры

utf8Json: Stream

UTF-8 Stream для записи.

value: TValue

Преобразуемое значение .

jsonTypeInfo: JsonTypeInfo<TValue>

Метаданные о преобразуемом типе.

Исключения

ArgumentNullException

utf8Json равно null.

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

Применяется к

Serialize<TValue>(TValue, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Преобразует значение типа, указанного параметром универсального типа, в строку 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);

public static string Serialize<TValue>(TValue value, System.Text.Json.JsonSerializerOptions? options = default);

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

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

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

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

Public Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

Параметры типа

TValue

Тип сериализации значения.

Параметры

value: TValue

Преобразуемое значение .

options: JsonSerializerOptions

Параметры управления поведением сериализации.

Возвращаемое значение

String

Строковое представление значения в формате JSON.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

Применяется к

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

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Исходный код:: JsonSerializer.Write.String.cs

Преобразует предоставленное значение в 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

Параметры типа

TValue

Тип сериализации значения.

Параметры

value: TValue

Преобразуемое значение .

jsonTypeInfo: JsonTypeInfo<TValue>

Метаданные о преобразуемом типе.

Возвращаемое значение

String

Представление String значения.

Исключения

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

ArgumentNullException

jsonTypeInfo равно null.

Использование не String так эффективно, как использование кодировки UTF-8, так как реализация внутренне использует UTF-8. См. также SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) и SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).

Применяется к

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Исходный код:: JsonSerializer.Write.Stream.cs

Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Streamтекст.

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

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

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

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)

Параметры типа

TValue

Тип сериализации значения.

Параметры

utf8Json: Stream

UTF-8 Stream для записи.

value: TValue

Преобразуемое значение .

options: JsonSerializerOptions

Параметры для управления поведением преобразования.

Атрибуты: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

utf8Json равно null.

NotSupportedException

Нет совместимых JsonConverter элементов TValue или его сериализуемых элементов.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

JsonSerializer.Serialize Метод

Определение

Перегрузки

Serialize(Object, JsonTypeInfo)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Serialize(Stream, Object, JsonTypeInfo)

Параметры

Исключения

Применяется к

Serialize(Object, Type, JsonSerializerOptions)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Serialize(Object, Type, JsonSerializerContext)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Параметры

Исключения

Применяется к

Serialize(Stream, Object, Type, JsonSerializerOptions)

Параметры

Исключения

Применяется к

Serialize(Stream, Object, Type, JsonSerializerContext)

Параметры

Исключения

Применяется к

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Параметры

Исключения

Комментарии

Применяется к

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Параметры

Исключения

Применяется к

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

Параметры типа

Параметры

Исключения

Применяется к

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Параметры типа

Параметры

Исключения

Комментарии

Применяется к

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

Параметры типа

Параметры

Исключения

Применяется к

Serialize<TValue>(TValue, JsonSerializerOptions)

Параметры типа

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

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

Параметры типа

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Параметры типа

Параметры

Исключения