JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Método

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Intenta analizar un valor JSON (incluidos objetos o matrices) del lector proporcionado.

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

Parámetros

reader

Utf8JsonReader

El lector que se va a leer.

document

JsonDocument

Cuando este método devuelve un resultado, contiene el valor analizado.

Devoluciones

Boolean

true si un valor se leyó y analizó en un objeto JsonDocument; false si el lector se quedó sin datos durante el análisis. Las demás situaciones dan como resultado una excepción.

Excepciones

ArgumentException

reader contiene opciones no compatibles.

o bien

El token reader actual no inicia o representa un valor.

JsonException

No se pudo leer un valor del lector.

Comentarios

Si la TokenType propiedad de reader es JsonTokenType.PropertyName o JsonTokenType.None, el lector avanzará mediante una llamada a para Utf8JsonReader.Read() determinar el inicio del valor.

Tras la finalización de este método, reader se coloca en el token final en el valor JSON. Si se produce false o se devuelve una excepción, el lector se restablece al estado en el que se encontraba cuando se llamó al método .

Este método realiza una copia de los datos en los que ha actuado el lector, por lo que no hay ningún requisito del autor de la llamada para mantener la integridad de los datos más allá del retorno de este método.