Freigeben über


Stream-Objekt (ADO)

Stellt einen Datenstrom von Binärdaten oder Text dar.

In strukturstrukturstrukturierten Hierarchien wie einem Dateisystem oder einem E-Mail-System weist ein Record- möglicherweise einen standardmäßigen binären Bitdatenstrom auf, der den Inhalt der Datei oder der E-Mail enthält. Ein Stream-Objekt kann verwendet werden, um Felder oder Datensätze zu bearbeiten, die diese Datenströme enthalten. Ein Stream-Objekt kann auf folgende Weise abgerufen werden:

  • Von einer URL, die auf ein Objekt verweist (in der Regel eine Datei), die binär- oder Textdaten enthält. Dieses Objekt kann ein einfaches Dokument, ein Record-Objekt sein, das ein strukturiertes Dokument oder einen Ordner darstellt.

  • Durch Öffnen des Standardobjekts Stream einem Record-Objekt zugeordnet. Sie können den Standarddatenstrom abrufen, der einem Record-Objekt zugeordnet ist, wenn das Record geöffnet wird, um einen Roundtrip zu vermeiden, um den Datenstrom zu öffnen.

  • Durch Instanziieren eines Stream-Objekts. Diese Stream-Objekte können zum Speichern von Daten für die Zwecke Ihrer Anwendung verwendet werden. Im Gegensatz zu einer Stream-, die einer URL zugeordnet ist, oder dem Standard-Stream- eines Record-, weist ein instanziiertes Stream- standardmäßig keine Zuordnung zu einer zugrunde liegenden Quelle auf.

Mit den Methoden und Eigenschaften eines Stream-Objekts können Sie folgende Aktionen ausführen:

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

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

  • Eingabebytes oder Text in ein Stream- mit den Methoden Write und WriteText.

  • Lesen von Bytes aus dem Stream- mit den Methoden Read und ReadText.

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

  • Kopieren Sie den Inhalt eines Stream- in eine andere Stream- mit der CopyTo-Methode.

  • 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 SetEOS--Methode.

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

  • Geben Sie den Zeichensatz an, der zum Speichern des Stream- mit der eigenschaft Charset verwendet wird.

  • Anhalten eines asynchronen Stream--Vorgangs mit der Cancel-Methode.

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

  • Steuern Sie die aktuelle Position innerhalb eines Stream- mit der eigenschaft Position.

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

  • Ermitteln Sie den aktuellen Status des Stream- (geschlossen, geöffnet oder ausgeführt) mit der eigenschaft State.

  • Geben Sie den Zugriffsmodus für die Stream- mit der eigenschaft Mode an.

Anmerkung

URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet Publishingauf. Weitere Informationen finden Sie unter absoluten und relativen URLs.

Das Stream-Objekt ist sicher für skripting.

Dieser Abschnitt enthält die folgenden Themen.

Siehe auch

Datensätze und Datenströme