Freigeben über


Stream-Objekt (ADO)

Stellt einen Datenstrom aus Binärdaten oder Text dar.

In Hierarchien mit Baumstruktur (z. B. ein Dateisystem oder ein E-Mail-System) kann ein Record-Objekt über einen Standardbinärdatenstrom aus Bits verfügen, der die Inhalte der Datei oder E-Mail enthält. Ein Stream-Objekt kann zum bearbeiten von Feldern oder Datensätzen verwendet werden, die diese Datenstreams enthalten. Stream-Objekte können wie folgt abgerufen werden:

  • Über eine URL, die auf ein Objekt (üblicherweise eine Datei) zeigt, das Binär- oder Textdaten beinhaltet. Bei diesem Objekt kann es sich um ein einfaches Dokument, ein Record-Objekt zur Darstellung eines strukturierten Dokuments oder einen Ordner handeln.

  • Durch das Öffnen des Stream-Standardobjekts, das einem Record-Objekt zugeordnet ist. Sie können den Standarddatenstrom abrufen, der einem Record-Objekt zugeordnet ist, wenn das Record-Objekt geöffnet wird. Dadurch wird der Roundtrip zum Öffnen des Datenstroms umgangen.

  • Durch das Instanziieren eines Stream-Objekts. Diese Stream-Objekte können zum Speichern von Daten für Ihre Anwendungszwecke verwendet werden. Im Gegensatz zu einem Stream-Objekt, dass einer URL zugeordnet ist, und im Gegensatz zum Stream-Standardobjekt eines Record-Objekts, ist ein instanziiertes Stream-Objekt standardmäßig keiner zugrunde liegenden Quelle zugeordnet.

Die Methoden und Eigenschaften eines Stream-Objekts ermöglichen Ihnen Folgendes:

  • Öffnen Sie ein Stream-Objekt mit der Open-Methode aus einem Record-Objekt oder über eine URL.

  • Schließen Sie ein Stream-Objekt mit der Close-Methode.

  • Geben Sie Bytes oder Text mit den Methoden Write und WriteText in ein Stream-Objekt ein.

  • Lesen Sie Bytes mit den Methoden Read und ReadText aus einem Stream-Objekt.

  • Schreiben Sie Stream-Daten, die sich noch im ADO-Puffer befinden, mit der Flush-Methode in das zugrunde liegende Objekt.

  • Kopieren Sie die Inhalte eines Stream-Objekts mit der CopyTo-Methode in ein anderes Stream-Objekt.

  • Steuern Sie, wie Zeilen aus der Quelldatei mit der SkipLine-Methode und der LineSeparator-Eigenschaft gelesen werden.

  • Bestimmen Sie das Ende der Datenstromposition mit der EOS-Eigenschaft und der SetEOS-Methode.

  • Speichern und Wiederherstellen von Daten in Dateien mit den Methoden SaveToFile und LoadFromFile .

  • Geben Sie den zum Speichern des Stream-Objekts verwendeten Zeichensatz mit der Charset-Eigenschaft an.

  • Halten Sie einen asynchronen Stream-Vorgang mit der Cancel-Methode an.

  • Bestimmen Sie die Anzahl von Bytes in einem Stream-Objekt mit der Size-Eigenschaft.

  • Steuern Sie die aktuelle Position in einem Stream-Objekt mit der Position-Eigenschaft.

  • Bestimmen Sie den Datentyp in einem Stream-Objekt mit der Type-Eigenschaft.

  • Bestimmen Sie den aktuellen Zustand des Stream-Objekts (geschlossen, geöffnet oder ausgeführt) mit der State-Eigenschaft.

  • Geben Sie den Zugriffsmodus für das Stream-Objekt mit der Mode-Eigenschaft an.

Hinweis

URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet-Publishing auf. Weitere Informationen finden Sie unter Absolute und relative URLs.

Das Stream-Objekt ist für die Skripterstellung sicher.

In diesem Abschnitt werden die folgenden Themen behandelt:

Weitere Informationen

Datensätze und Datenströme