JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Метод

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Пытается проанализировать одно значение 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

Значение true, если значение было считано и проанализировано в JsonDocument; значение false, если модулю чтения не хватило данных во время анализа. Во всех других ситуациях возникает исключение.

Исключения

ArgumentException

reader содержит неподдерживаемые параметры.

-или-

Текущий маркер reader не запускается или не представляет значение.

JsonException

Не удалось считать значение из модуля чтения.

Комментарии

TokenType Если свойство reader имеет JsonTokenType.PropertyName значение или JsonTokenType.None, средство чтения перемещается на один вызов, чтобы Utf8JsonReader.Read() определить начало значения.

По завершении этого метода reader позиционируется в последнем токене в значении JSON. Если создается или false возвращается исключение, средство чтения сбрасывается в состояние, в которое он находился при вызове метода.

Этот метод создает копию данных, с помощью которые средство чтения действовало, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возвращения этого метода.