JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) メソッド

定義

指定されたリーダーから 1 つの 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

メソッドから制御が戻るときに、解析されたドキュメントが格納されます。

返品

true 値が読み取られ、JsonDocument に解析された場合。解析中にリーダーがデータを使い果たした場合に false します。 それ以外のすべての状況では、例外がスローされます。

例外

reader には、サポートされていないオプションが含まれています。

-又は-

現在の reader トークンは、値を開始または表していません。

値をリーダーから読み取れませんでした。

注釈

readerTokenType プロパティがJsonTokenType.PropertyNameまたはJsonTokenType.Noneの場合、リーダーは 1 回の呼び出しでUtf8JsonReader.Read()に進み、値の開始を決定します。

このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、または false が返された場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。

このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。

適用対象