Open-Methode (ADO Stream)
Öffnet ein Stream--Objekt, um Datenströme von Binären oder Textdaten zu bearbeiten.
Syntax
Stream.Open Source, Mode , OpenOptions, UserName, Password
Parameter
Source-
Wahlfrei. Ein Variant Wert, der die Datenquelle für die Stream-angibt.
Source- kann eine absolute URL-Zeichenfolge enthalten, die auf einen vorhandenen Knoten in einer bekannten Struktur verweist, z. B. eine E-Mail oder ein Dateisystem. Eine URL sollte mithilfe des URL-Schlüsselworts ("URL=Schema://Server/Ordner") angegeben werden. Alternativ kann Source- einen Verweis auf ein bereits geöffnetes Record-Objekt enthalten, das den dem Recordzugeordneten Standarddatenstrom öffnet. Wenn Source- nicht angegeben ist, wird ein Stream- instanziiert und geöffnet, das standardmäßig keiner zugrunde liegenden Quelle zugeordnet ist. Weitere Informationen zu URL-Schemas und den zugehörigen Anbietern finden Sie unter absolute und relative URLs.
Modus-
Wahlfrei. Ein ConnectModeEnum Wert, der den Zugriffsmodus für das resultierende Stream- angibt (z. B. Lese-/Schreibzugriff oder schreibgeschützt). Der Standardwert ist adModeUnknown. Weitere Informationen zu Zugriffsmodi finden Sie in der Mode-Eigenschaft. Wenn Modus nicht angegeben ist, wird sie vom Quellobjekt geerbt. Wenn die Quelle z. B. Record im schreibgeschützten Modus geöffnet wird, wird das Stream- standardmäßig auch im schreibgeschützten Modus geöffnet.
OpenOptions-
Wahlfrei. Ein StreamOpenOptionsEnum Wert. Der Standardwert ist adOpenStreamUnspecified.
UserName-
Wahlfrei. Ein String- Wert, der die Benutzeridentifikation enthält, die bei Bedarf auf das Stream-Objekt zugreift.
Kennwort
Wahlfrei. Ein String- Wert, der das Kennwort enthält, das bei Bedarf auf das Stream-Objekt zugreift.
Bemerkungen
Wenn ein Record-Objekt als Quellparameter übergeben wird, werden die Parameter UserID und Password nicht verwendet, da der Zugriff auf das Record-Objekt bereits verfügbar ist. Ebenso wird die Mode- des Record-Objekts an das Stream-Objekt übertragen. Wenn Source nicht angegeben ist, enthält das Stream- geöffnet keine Daten und weist eine Größe null (0) auf. Um zu vermeiden, dass daten verloren gehen, die in diese Stream- geschrieben werden, wenn die Stream geschlossen wird, speichern Sie die Stream mit dem CopyTo oder SaveToFile Methoden, oder speichern Sie sie an einem anderen Speicherort.
Ein OpenOptions- Wert von adOpenStreamFromRecord identifiziert den Inhalt des Parameters Source als bereits geöffnetes Record-Objekt. Das Standardverhalten besteht darin, Source- als URL zu behandeln, die direkt auf einen Knoten in einer Struktur verweist, z. B. eine Datei. Der diesem Knoten zugeordnete Standarddatenstrom wird geöffnet.
Obwohl die Stream- nicht geöffnet ist, ist es möglich, alle schreibgeschützten Eigenschaften der Stream-zu lesen. Wenn ein Stream- asynchron geöffnet wird, werden alle nachfolgenden Vorgänge (außer überprüfung des State und anderer schreibgeschützter Eigenschaften) blockiert, bis der vorgang Öffnen abgeschlossen ist.
Zusätzlich zu den zuvor erläuterten Optionen, indem Sie nicht Sourceangeben, können Sie eine Instanz eines Stream-Objekts im Arbeitsspeicher erstellen, ohne es einer zugrunde liegenden Quelle zuzuordnen. Sie können dem Datenstrom dynamisch Daten hinzufügen, indem Sie Binär- oder Textdaten in das Stream- mit Write oder WriteText-schreiben oder Daten aus einer Datei mit LoadFromFile-laden.
Gilt für
Siehe auch
Open-Methode (ADO-Verbindung)
Open-Methode (ADO Record)
Open-Methode (ADO-Recordset)
OpenSchema-Methode
SaveToFile-Methode