JsonDocument.ParseValue(Utf8JsonReader) 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

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

Source:

JsonDocument.Parse.cs

通过提供的读取器分析一个 JSON 值（包括对象或数组）。

public:
 static System::Text::Json::JsonDocument ^ ParseValue(System::Text::Json::Utf8JsonReader % reader);

public static System.Text.Json.JsonDocument ParseValue (ref System.Text.Json.Utf8JsonReader reader);

static member ParseValue : Utf8JsonReader -> System.Text.Json.JsonDocument

Public Shared Function ParseValue (ByRef reader As Utf8JsonReader) As JsonDocument

参数

reader

Utf8JsonReader

要用于读取的读取器。

返回

JsonDocument

表示从读取器中读取的值（和嵌套值）的 JsonDocument。

例外

ArgumentException

reader 包含不受支持的选项。

- 或 -

当前 reader 令牌不启动或表示值。

JsonException

无法从读取器中读取值。

注解

TokenType如果 的 reader 属性为 JsonTokenType.PropertyName 或 JsonTokenType.None，则读取器将通过一次调用 Utf8JsonReader.Read() 来确定值的开头。

完成此方法后， reader 位于 JSON 值中的最终标记处。 如果引发异常，读取器将重置为调用 方法时处于的状态。

此方法会复制读取者处理的数据，因此，除了此方法的返回之外，调用方不需要维护数据完整性。