System.JSON.BSON.TBsonReader
Delphi
TBsonReader = class(TJsonReader)
C++
class PASCALIMPLEMENTATION TBsonReader : public System::Json::Readers::TJsonReader
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | System.JSON.BSON.pas System.JSON.BSON.hpp |
System.JSON.BSON | System.JSON.BSON |
Beschreibung
Klasse zum Lesen von Daten, die im BSON-Format serialisiert sind.
Um BSON-Daten zu lesen:
- Erstellen Sie einen BSON-Reader, der Daten von einem Daten-Stream liest.
- Rufen Sie Read auf, damit der Reader zum ersten BSON-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 einer angegebenen Menge von Token-Typen angehört.
- CurrentElementType gibt den BSON-Typ des Werts des Token an.
- Value stellt den Zugriff auf den Wert des Token bereit. Der Typ eines Tokens und der BSON-Typ dessen Werts legen die Methode von Value fest, die Sie verwenden müssen, um auf den Wert des Token zuzugreifen. Wenn TokenType z. B.
PropertyNameund CurrentElementTypeStringist, müssen Sie Value.AsString aufrufen, um auf einen Eigenschaftsnamen zuzugreifen. - CurrentState gibt den Status des Readers an.
- LineNumber und LinePosition geben die Position in den Eingabedaten an, in der sich der Reader befindet.
- Rufen Sie weiter Read auf, um alle BSON-Tokens der Eingabedaten zu durchsuchen. Read gibt
Falsezurü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 antizipieren können:
TJsonTextReader stellt auch einige weitere Features bereit:
- CloseInput legt fest, ob der Reader den Stream-Reader, der die Eingabedaten bereitstellt, beim Schließen des Readers schließt (
True), oder nicht (False). - Reader stellt den Zugriff auf den zugrunde liegenden Binär-Reader bereit, den der BSON-Reader verwendet.
- Rewind setzt den Reader auf den Status zurück, auf den er gesetzt ist, wenn Sie ihn erstellen, aber der Stream-Reader, der die Eingabedaten bereitstellt, wird nicht zurückgesetzt.