JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

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

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] Nullable<System::Text::Json::JsonElement> % element);

public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonElement? element);

static member TryParseValue : Utf8JsonReader * Nullable -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef element As Nullable(Of JsonElement)) As Boolean

参数

reader

Utf8JsonReader

要用于读取的读取器。

element

Nullable<JsonElement>

接收分析的元素。

返回

Boolean

true 如果已读取并分析到 JsonElement 中，则为值; false 如果读取器在分析时数据不足，则为 所有其他情况都会导致引发异常。

例外

ArgumentException

reader 使用的是不受支持的选项。

ArgumentException

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

JsonException

无法从读取器中读取值。

注解

TokenType如果属性reader为PropertyName或None，则读取器将由一个调用高级，以确定Read()值的开始。

完成此方法后， reader 将定位在 JSON 值的最终令牌上。 如果引发或 false 返回异常，则读取器将重置为调用该方法时处于的状态。

此方法创建读取器所处理的数据的副本，因此，除了此方法的返回之外，不需要调用方维护数据完整性。