System.JSON.Readers.TJsonTextReader
Delphi
TJsonTextReader = class(TJsonReader)
C++
class PASCALIMPLEMENTATION TJsonTextReader : public TJsonReader
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
class | public | System.JSON.Readers.pas System.JSON.Readers.hpp |
System.JSON.Readers | System.JSON.Readers |
Beschreibung
Klasse zum Lesen von Daten, die im JSON-Format serialisiert sind.
Um JSON-Daten zu lesen:
- Erstellen Sie einen JSON-Reader, der Daten von einem Text-Reader liest.
- Rufen Read auf, damit der Reader zum ersten JSON-Token der Eingabedaten gesetzt wird.
- TokenType gibt den Typ des Token an. Sie können auch IsPrimitiveToken, IsStartToken oder IsEndToken verwenden, um festzulegen, ob der Typ des Token zu einer festgelegten Menge von Tokentypen gehört.
- Value stellt Zugriff auf den Wert des Token bereit. Der Typ eines Token legt den Typ seines Werts fest, der die Methode von Value festlegt, die Sie verwenden müssen, um auf den Wert des Token zuzugreifen. Wen z. B. TokenType
PropertyName
ist, müssen Sie Value.AsString aufrufen, um auf den Eigenschaftsnamen zuzugreifen. - CurrentState gibt den Status des Readers an.
- LineNumber und LinePosition geben die Position in den Eingabedaten, wo sich der Reader befindet, an.
- Rufen Sie weiter Read auf, um alle JSON-Tokens der Eingabedaten zu durchsuchen. Read gibt
False
zurück, wenn das Ende der Eingabedaten erreicht wird. - Wenn das Lesen der Eingabedaten beendet wurde, können Sie den Reader entweder schließen oder freigeben.
Statt Read können Sie alternativ jede der folgenden ,Lesemethoden verwenden, wenn Sie den Typ des nächsten Token vorausnehmen können:
TJsonTextReader stellt auch die folgenden zusätzlichen Features bereit:
- CloseInput legt fest, ob der Reader den Stream-Reader schließt, der die Eingabedaten bereitstellt, wenn Sie den Reader schließen (
True
), oder nicht (False
). - Rewind setzt den Reader auf den Status zurück, den er beim Erstellen besitzt, setzt aber nicht den Stream-Reader zurück, der die Eingabedaten bereitstellt.