JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Tenta analisar um valor JSON (incluindo matrizes ou objetos) do leitor fornecido.

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

O leitor a ser lido.

document

JsonDocument

Quando retorna, o método contém o documento analisado.

Retornos

Boolean

true se um valor foi lido e analisado em um JsonDocument; false se o leitor ficou sem dados durante a análise. Todas as outras situações resultam no lançamento de uma exceção.

Exceções

ArgumentException

reader contém opções sem suporte.

- ou -

O token reader atual não inicia ou representa um valor.

JsonException

Não foi possível ler um valor do leitor.

Comentários

Se a TokenType propriedade for reader JsonTokenType.PropertyName ou JsonTokenType.None, o leitor avançará por uma chamada para Utf8JsonReader.Read() determinar o início do valor.

Após a conclusão desse método, reader é posicionado no token final no valor JSON. Se uma exceção for lançada ou false retornada, o leitor será redefinido para o estado em que estava quando o método foi chamado.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.