JsonDocument.ParseAsync 方法

定义

将表示单个 JSON 值的 UTF-8 编码数据形式的 Stream 分析为 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

要监视取消请求的标记。

返回

用于生成 JSON 值的 JsonDocument 表示的任务。

例外

utf8Json 不表示有效的单个 JSON 值。

options 包含不受支持的选项。

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法将存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 Parse(Stream, JsonDocumentOptions)异常。

适用于