JsonSerializer.SerializeAsync Метод

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Перегрузки

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Stream.
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)	Асинхронно преобразует значение указанного типа в текст JSON в кодировке UTF-8 и записывает его в указанный поток.
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Stream.
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)	Асинхронно преобразует значение типа, указанного параметром универсального типа, в текст JSON в кодировке UTF-8 и записывает его в поток.
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)	Преобразует предоставленное значение в текст JSON в кодировке UTF-8 и записывает его в Stream.

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

Исходный код:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

utf8Json

Stream

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

value

Object

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

inputType

Type

Тип преобразованного value.

context

JsonSerializerContext

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

cancellationToken

CancellationToken

CancellationToken, которые можно использовать для отмены операции записи.

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

Task

Задача, представляющая асинхронную операцию записи.

Исключения

ArgumentException

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

ArgumentNullException

utf8Json, inputTypeили contextnull.

NotSupportedException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Serialize(Stream, Object, Type, JsonSerializerContext).

SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)

Исходный код:

JsonSerializer.Write.Stream.cs

Асинхронно преобразует значение указанного типа в текст JSON в кодировке UTF-8 и записывает его в указанный поток.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

utf8Json

Stream

Поток UTF-8 для записи.

value

Object

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

inputType

Type

Тип преобразованного value.

options

JsonSerializerOptions

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

cancellationToken

CancellationToken

Маркер, который может использоваться для отмены операции записи.

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

Task

Задача, представляющая асинхронную операцию записи.

Исключения

ArgumentException

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

ArgumentNullException

utf8Json или inputTypenull.

NotSupportedException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Serialize(Stream, Object, Type, JsonSerializerOptions).

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Исходный код:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

utf8Json

Stream

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

value

Object

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

jsonTypeInfo

JsonTypeInfo

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

cancellationToken

CancellationToken

CancellationToken, которые можно использовать для отмены операции записи.

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

Task

Задача, представляющая асинхронную операцию записи.

Исключения

ArgumentNullException

utf8Json null.

InvalidCastException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)

Исходный код:

JsonSerializer.Write.Stream.cs

Асинхронно преобразует значение типа, указанного параметром универсального типа, в текст JSON в кодировке UTF-8 и записывает его в поток.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

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

TValue

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

Параметры

utf8Json

Stream

Поток UTF-8 для записи.

value

TValue

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

options

JsonSerializerOptions

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

cancellationToken

CancellationToken

Маркер, который может использоваться для отмены операции записи.

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

Task

Задача, представляющая асинхронную операцию записи.

Исключения

ArgumentNullException

utf8Json null.

NotSupportedException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

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

SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)

Исходный код:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

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

TValue

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

Параметры

utf8Json

Stream

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

value

TValue

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

jsonTypeInfo

JsonTypeInfo<TValue>

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

cancellationToken

CancellationToken

CancellationToken, которые можно использовать для отмены операции записи.

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

Task

Задача, представляющая асинхронную операцию записи.

Исключения

ArgumentNullException

utf8Json null.

NotSupportedException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.