JsonElement.ParseValue(Utf8JsonReader) Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

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

public:
 static System::Text::Json::JsonElement ParseValue(System::Text::Json::Utf8JsonReader % reader);

public static System.Text.Json.JsonElement ParseValue (ref System.Text.Json.Utf8JsonReader reader);

static member ParseValue : Utf8JsonReader -> System.Text.Json.JsonElement

Public Shared Function ParseValue (ByRef reader As Utf8JsonReader) As JsonElement

Parâmetros

reader

Utf8JsonReader

O leitor a ser lido.

Retornos

JsonElement

Um JsonElement que representa o valor (e valores aninhados) lido do leitor.

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, 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.