JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

會嘗試從提供的讀取器剖析一個 JSON 值 (包括物件或陣列)。

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] System::Text::Json::JsonDocument ^ % document);

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

public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonDocument document);

static member TryParseValue : Utf8JsonReader * JsonDocument -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As Boolean

參數

reader

Utf8JsonReader

要讀取的讀取器。

document

JsonDocument

當這個方法傳回時，會包含剖析的文件。

傳回

Boolean

如果已讀取值並已將其剖析為 JsonDocument，則為 true；如果讀取器在剖析時用盡資料，則為 false。 所有其他情況都會導致擲回例外狀況。

例外狀況

ArgumentException

reader 包含不支援的選項。

-或-

目前的 reader 權杖不會啟動或表示值。

JsonException

無法從讀取器讀取某個值。

備註

如果 的 TokenType reader 屬性為 JsonTokenType.PropertyName 或 JsonTokenType.None ，則讀取器會逐一呼叫來 Utf8JsonReader.Read() 判斷值的開頭。

完成此方法時， reader 會位於 JSON 值的最後一個權杖。 如果擲回或 false 傳回例外狀況，讀取器會重設為呼叫 方法時的狀態。

這個方法會讓讀取器採取動作的資料複本，因此不需要呼叫端維護此方法傳回以外的資料完整性。