Compartilhar via


JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) Método

Definição

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

reader está usando opções incompatíveis.

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

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.

Aplica-se a