JsonDocument.ParseAsync Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

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

JsonDocument.Parse.cs

Анализирует Stream в виде данных в кодировке UTF-8, представляющих отдельное значение JSON в JsonDocument. Поток считывается до завершения.

public static System.Threading.Tasks.Task<System.Text.Json.JsonDocument> ParseAsync (System.IO.Stream utf8Json, System.Text.Json.JsonDocumentOptions options = default, System.Threading.CancellationToken cancellationToken = default);

static member ParseAsync : System.IO.Stream * System.Text.Json.JsonDocumentOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Text.Json.JsonDocument>

Public Shared Function ParseAsync (utf8Json As Stream, Optional options As JsonDocumentOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of JsonDocument)

Параметры

utf8Json

Stream

Анализируемые данные JSON.

options

JsonDocumentOptions

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

cancellationToken

CancellationToken

Токен для отслеживания запросов отмены.

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

Task<JsonDocument>

Задача по созданию представления JsonDocument данного значения JSON.

Исключения

JsonException

utf8Json не представляет допустимое отдельное значение JSON.

ArgumentException

options содержит неподдерживаемые параметры.

OperationCanceledException

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

Комментарии

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