JsonDocument.ParseAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将表示单个 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)异常。