TJsonObject

Turma

type TJsonObject = class(TJson)

Representa um objeto JSON. Contém 0 ou mais elementos que são pares nome/valor. É possível aceder aos membros por nome ou por índice.

Características

MemberCount: Integer read;

Retorna o número de membros do objeto.

MemberName[Index: Integer]: WideString de leitura e escrita;

Definir/recuperar o nome do membro especificado.

MemberValue[Índice: Inteiro]: TJson leitura/gravação;

Definir/recuperar o valor do membro especificado.

Membros[const Nome: WideString]: TJson leitura e gravação; padrão;

Definir/recuperar o membro especificado. Retorna nil se não for encontrado.

NullItem[const Name: WideString]: TJsonNull read;

FalseItem[const Name: WideString]: TJsonFalse read;

TrueItem[const Name: WideString]: TJsonTrue read;

ObjectItem[const Name: WideString]: TJsonObject read;

StringItem[const Name: WideString]: TJsonString read;

ArrayItem[const Name: WideString]: TJsonArray read;

NumberItem[const Name: WideString]: TJsonNumber read;

Devolve o membro especificado se o nome for válido e o tipo solicitado corresponder ao conteúdo.

Métodos

construtor Create;

Cria uma instância de TJsonObject.

procedimento DeleteAll;

Elimina todos os membros.

procedimento Delete(Index: Integer); sobrecarga;

procedimento Delete(const Name: WideString); sobrecarga;

Elimina o membro especificado.

função Find(const Nome: WideString): Integer;

Encontra o índice do membro especificado. Retorna -1 se não for encontrado.

função SetArray(const Name: WideString; ElementCount: Integer): TJsonArray;

procedimento SetDateTime(const Name: WideString; const Value: TDateTime; Offset: Integer = 0);

procedimento SetFalse(const Name: WideString);

função SetJson(const Name: WideString; Value: TJson): TJson;

procedimento SetNull(const Name: WideString);

procedimento SetNumber(const Name: WideString; Value: Double);

função SetObject(const Name: WideString): TJsonObject;

procedimento SetString(const Name: WideString; const Value: WideString);

procedimento SetTrue(const Name: WideString);

Os métodos Set criam/convertem o membro especificado para o tipo e valor especificados. As funções SetArray, SetJson e SetObject devolvem instâncias dos elementos recém-modificados para posterior manipulação.

Exemplo

jObject = TJsonObject.Create 'Cria um objeto vazio
showmessage(jObject.MemberCount) 'exibe 0

jObject.SetNull("Null")
showmessage(jObject.MemberCount) 'exibe 1

jObject.SetFalse("False")
showmessage(jObject.MemberCount) 'exibe 2

jObject.DeleteAll
showmessage(jObject.MemberCount) 'exibe 0 |