JsonDocument.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::JsonDocument ^ ParseValue(System::Text::Json::Utf8JsonReader % reader);

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

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

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

Parâmetros

reader

Utf8JsonReader

O leitor a ser lido.

Retornos

JsonDocument

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

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 gerada, 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.