JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Metodo

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Prova ad analizzare un valore JSON (inclusi gli oggetti o le matrici) dal lettore specificato.

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

Parametri

reader

Utf8JsonReader

Lettore per eseguire la lettura.

document

JsonDocument

Quando termina, questo metodo contiene il documento analizzato.

Restituisce

Boolean

true se un valore è stato letto e convertito in un JsonDocument; false se il lettore ha esaurito i dati durante l'analisi. In tutti gli altri casi viene generata un'eccezione.

Eccezioni

ArgumentException

reader contiene opzioni non supportate.

-oppure-

Il token reader non avvia o rappresenta un valore.

JsonException

Il lettore non è riuscito a leggere un valore.

Commenti

Se la TokenType proprietà di reader è JsonTokenType.PropertyName o JsonTokenType.None, il lettore procederà di una chiamata a Utf8JsonReader.Read() per determinare l'inizio del valore.

Al termine di questo metodo, reader viene posizionato al token finale nel valore JSON. Se viene generata un'eccezione o false viene restituita, il lettore viene reimpostato sullo stato in cui si trovava quando è stato chiamato il metodo .

Questo metodo crea una copia dei dati su cui il lettore agisce, pertanto non è necessario che il chiamante mantenga l'integrità dei dati oltre la restituzione di questo metodo.