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

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

System.Text.Json v11.0.0-preview.5.26302.115

Исходный код:

JsonDocument.Parse.cs

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

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 возвращается, средство чтения сбрасывается в состояние, в которое он был вызван.

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