JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたリーダーから 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のTokenType プロパティがJsonTokenType.PropertyNameまたはJsonTokenType.Noneの場合、リーダーは 1 回の呼び出しでUtf8JsonReader.Read()に進み、値の開始を決定します。
このメソッドが完了すると、 reader は JSON 値の最後のトークンに配置されます。 例外がスローされた場合、または false が返された場合、リーダーはメソッドが呼び出されたときの状態にリセットされます。
このメソッドは、リーダーが操作したデータのコピーを作成するため、このメソッドの戻り値を超えてデータの整合性を維持する呼び出し元の要件はありません。