JsonDocument.ParseValue(Utf8JsonReader) 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

從提供的讀取器剖析一個 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 值的最後一個權杖。 如果擲回例外狀況，讀取器會重設為呼叫 方法時的狀態。

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