JsonDocument.ParseAsync 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

System.Text.Json v9.0.0-preview.3.24172.9

Source:

JsonDocument.Parse.cs

将表示单个 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

要监视取消请求的标记。

返回

Task<JsonDocument>

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

例外

JsonException

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

ArgumentException

options 包含不受支持的选项。

OperationCanceledException

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

注解

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