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

定義

名前空間:

System.Text.Json

アセンブリ:

System.Text.Json.dll

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

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

戻り値

Boolean

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

例外

ArgumentException

reader に、サポート対象外のオプションが含まれています。

• または -

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

JsonException

リーダーから値を読み取ることができませんでした。

注釈

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

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

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