ADO StreamObjekt
Stream-Objekt (ADO-Version 2.5)
Das ADO-Stream-Objekt wird zum Lesen, Schreiben und Verwalten von binären Daten oder Textstreams verwendet.
Das Stream-Objekt kann auf drei Arten abgerufen werden:
- Durch Verweisen auf eine URL, die ein Objekt (normalerweise eine Datei) mit binären Daten oder Textdaten enthält. Dieses Objekt kann ein einfaches Dokument, ein Record-Objekt, das ein strukturiertes Dokument darstellt, oder ein Ordner sein.
- Durch Instanziieren eines Stream-Objekts. Diese Stream-Objekte können verwendet werden, um Daten für eine Anwendung zu speichern. Im Gegensatz zu einem Stream, der einer URL zugeordnet ist, oder zum Standard-Stream eines Records, ist ein instanziierter Stream standardmäßig keiner zugrunde liegenden Quelle zugeordnet.
- Durch Öffnen des Standard-Stream-Objekts, das einem Record-Objekt zugeordnet ist. Wenn ein Record geöffnet wird, ist der dem Record-Objekt zugeordnete Standard-Stream verfügbar. Das bloße Öffnen dieses Streams eliminiert einen Roundtrip.
Syntax
objectname.property
objectname.method
objectname.method
Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
| CharSet | Gibt den Zeichensatz an, der zum Speichern des Streams verwendet wird. |
| EOS | Gibt zurück, ob sich die aktuelle Position am Ende des Streams befindet. |
| LineSeparator | Legt das in einem Text-Stream-Objekt verwendete Zeilentrennzeichen fest oder gibt es zurück. |
| Mode | Legt die verfügbaren Berechtigungen zum Ändern von Daten fest oder gibt sie zurück. |
| Position | Legt die aktuelle Position vom Anfang des Stream-Objekts (in Bytes) fest oder gibt sie zurück. |
| Size | Gibt die Größe eines geöffneten Stream-Objekts zurück. |
| State | Gibt einen Wert zurück, der angibt, ob der Stream geöffnet oder geschlossen ist. |
| Type | Legt den Datentyp im Stream-Objekt fest oder gibt ihn zurück. |
Methoden
| Methode | Beschreibung |
|---|---|
| Cancel | Bricht die Ausführung eines Open-Aufrufs für ein Stream-Objekt ab. |
| Close | Schließt ein Stream-Objekt. |
| CopyTo | Kopiert eine angegebene Anzahl von Zeichen/Bits von einem Stream-Objekt in ein anderes Stream-Objekt. |
| Flush | Sendet den Inhalt des Stream-Puffers an ein zugeordnetes zugrunde liegendes Objekt. |
| LoadFromFile | Lädt den Inhalt einer Datei in ein Stream-Objekt. |
| Open | Öffnet ein Stream-Objekt. |
| Read | Liest den gesamten Stream oder eine angegebene Anzahl von Bytes aus einem binären Stream-Objekt. |
| ReadText | Liest einen gesamten Stream, eine Zeile oder eine angegebene Anzahl von Bytes aus einem Text-Stream-Objekt. |
| SaveToFile | Speichert den binären Inhalt eines Stream-Objekts in einer Datei. |
| SetEOS | Setzt die aktuelle Position auf das Ende des Streams (EOS) |
| SkipLine | Überspringt eine Zeile beim Lesen eines Text-Streams. |
| Write | Schreibt binäre Daten in ein binäres Stream-Objekt. |
| WriteText | Schreibt Zeichendaten in ein Text-Stream-Objekt. |