JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
會嘗試從提供的讀取器剖析一個 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>
接收已剖析的專案。
傳回
true
如果已讀取並剖析為 JsonElement 的值,則為 ; false
如果讀取器在剖析時資料不足,則為 。
所有其他情況都會導致擲回例外狀況。
例外狀況
reader
正在使用不支援的選項。
目前的 reader
權杖不會啟動或表示值。
無法從讀取器讀取某個值。
備註
如果 的 TokenType reader
屬性為 PropertyName 或 None ,則讀取器將會由一個呼叫進階, Read() 以判斷值的開頭。
完成此方法時, reader
會位於 JSON 值的最後一個權杖。 如果擲回或 false
傳回例外狀況,讀取器會重設為呼叫 方法時的狀態。
這個方法會讓讀取器採取動作的資料複本,因此不需要呼叫端維護此方法傳回以外的資料完整性。