JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) 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] Nullable<System::Text::Json::JsonElement> % element);

public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonElement? element);

static member TryParseValue : Utf8JsonReader * Nullable -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef element As Nullable(Of JsonElement)) As Boolean

Parâmetros

reader

Utf8JsonReader

O leitor a ser lido.

element

Nullable<JsonElement>

Recebe o elemento analisado.

Retornos

Boolean

true se um valor foi lido e analisado em um JsonElement; 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 está usando opções incompatíveis.

ArgumentException

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 de reader é PropertyName ou None, o leitor será avançado por uma chamada para 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.