Freigeben über


Open-Methode (ADO-Datenstrom)

Öffnet ein Stream-Objekt, um Streams von Binär- oder Textdaten zu bearbeiten.

Syntax

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

Parameter

Quelle
Optional. Ein Variant-Wert, der die Quelle der Daten für den Stream angibt. Source kann eine absolute URL-Zeichenfolge enthalten, die auf einen vorhandenen Knoten in einer bekannten Struktur verweist, z. B. ein E-Mail- oder 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 Standardstream öffnet, der dem Record zugeordnet ist. Wenn Source nicht angegeben wird, wird ein Stream instanziiert und geöffnet, der standardmäßig keiner zugrunde liegenden Quelle zugeordnet ist. Weitere Informationen zu URL-Schemas und ihren zugeordneten Anbietern finden Sie unter Absolute und relative URLs.

Mode
Optional. Ein ConnectModeEnum-Wert, der den Zugriffsmodus für den resultierenden Stream angibt (z. B. Lese-/Schreibzugriff oder schreibgeschützt). Der Standardwert ist adModeUnknown. Weitere Informationen zu Zugriffsmodi finden Sie in der Mode-Eigenschaft. Wenn Mode nicht angegeben wird, wird er vom Quellobjekt geerbt. Wenn der Quell-Record beispielsweise im schreibgeschützten Modus geöffnet wird, wird der Stream standardmäßig auch im schreibgeschützten Modus geöffnet.

OpenOptions
Optional. Ein StreamOpenOptionsEnum-Wert. Der Standardwert ist adOpenStreamUnspecified.

UserName
Optional. Ein String-Wert, der die Benutzeridentifikation enthält, die bei Bedarf auf das Stream-Objekt zugreift.

Kennwort
Optional. 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, weil der Zugriff auf das Record-Objekt bereits verfügbar ist. Ebenso wird der Mode des Record-Objekts an das Stream-Objekt übertragen. Wenn Source nicht angegeben wird, enthält der geöffnete Stream keine Daten und hat die Size (Größe) Null (0). Um zu vermeiden, dass Daten verloren gehen, die in diesen Stream geschrieben werden, wenn der Stream geschlossen wird, speichern Sie den Stream mit der Methode CopyTo oder SaveToFile, oder speichern Sie ihn an einem anderen Speicherort.

Ein OpenOptions-Wert von adOpenStreamFromRecord identifiziert den Inhalt des Source-Parameters 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 Standard-Stream, der diesem Knoten zugeordnet ist, wird geöffnet.

Solange der Stream nicht geöffnet ist, ist es möglich, alle schreibgeschützten Eigenschaften des Streams zu lesen. Wenn ein Stream asynchron geöffnet wird, werden alle nachfolgenden Vorgänge (außer der Überprüfung der State- und anderer schreibgeschützter Eigenschaften) blockiert, bis der Open-Vorgang abgeschlossen ist.

Zusätzlich zu den zuvor besprochenen Optionen können Sie eine Instanz eines Stream-Objekts im Arbeitsspeicher erstellen, ohne sie einer zugrunde liegenden Quelle zuzuordnen, indem Sie Source nicht angeben. Sie können Daten dynamisch zum Stream hinzufügen, indem Sie Binär- oder Textdaten mit Write oder WriteText in den Stream schreiben, oder indem Sie Daten aus einer Datei mittels LoadFromFile laden.

Gilt für

Stream-Objekt (ADO)

Weitere Informationen

Open-Methode (ADO-Verbindung)
Open-Methode (ADO Record)
Open-Methode (ADO-Recordset)
OpenSchema-Methode
SaveToFile-Methode