Open-Methode (Stream in ADO)
Gilt für: Access 2013, Office 2013
Öffnet ein Stream-Objekt, um Datenströme von Binär- oder Textdaten zu ändern.
Syntax
Stream. Open Source, Mode, OpenOptions, UserName, Password
Parameter
| Parameter | Beschreibung |
|---|---|
| Source | Optional. Ein Variant-Wert, der die Datenquelle für das Stream-Objekt angibt. Die Quelle kann eine absolute URL-Zeichenfolge enthalten, die auf einen vorhandenen Knoten in einer bekannten Struktur wie einem E-Mail- oder Dateisystem verweist. Eine URL sollte mithilfe der URL Schlüsselwort (keyword) ("URL=scheme://server/folder") angegeben werden. Als Alternative kann Source einen Verweis auf ein bereits geöffnetes Record-Objekt enthalten, das den dem Record zugeordneten Standarddatenstrom öffnet. Ist Source nicht angegeben, wird ein Stream-Objekt 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. |
| Mode | Optional. Ein ConnectModeEnum-Wert, der den Zugriffsmodus für das resultierende Stream-Objekt angibt (z. B. Lese-/Schreibzugriff oder schreibgeschützt). Der Standardwert lautet adModeUnknown. Weitere Informationen zu Zugriffmodi erhalten Sie unter Mode-Eigenschaft. Ist Mode nicht angegeben, wird diese Methode vom Quellobjekt geerbt. Wenn der Quell-Record im schreibgeschützten Modus geöffnet ist, wird das Stream-Objekt standardmäßig auch im schreibgeschützten Modus geöffnet. |
| OpenOptions | Optional. Ein StreamOpenOptionsEnum-Wert. Der Standardwert lautet adOpenStreamUnspecified. |
| UserName | Optional. Ein String-Wert mit der Benutzeridentifikation, mit der bei Bedarf auf das Stream-Objekt zugegriffen wird. |
| Password | Optional. Ein String-Wert, der das Kennwort enthält, mit dem bei Bedarf auf das Stream-Objekt zugegriffen wird. |
Hinweise
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 der Modus des Record-Objekts an das Stream -Objekt übertragen. Wenn Source nicht angegeben ist, enthält die geöffnete Stream keine Daten und hat die Größe null (0). Um den Verlust von Daten zu vermeiden, die beim Schließen des Stream in diese Stream geschrieben werden, speichern Sie die Stream mit den Methoden CopyTo oder SaveToFile, oder speichern Sie sie an einem anderen Speicherort.
Ein OpenOptions-Wert adOpenStreamFromRecord identifiziert den Inhalt des Source-Parameters als ein bereits offenes Record-Objekt. Beim Standardverhalten wird Source wie eine URL behandelt, die direkt auf einen Knoten in einer Baumstruktur verweist (z. B. auf eine Datei). Der diesem Knoten zugeordnete Standarddatenstrom wird geöffnet.
Alle schreibgeschützten Eigenschaften des Stream -Objekts können selbst dann gelesen werden, wenn das Stream -Objekt nicht offen ist. Ist ein Stream-Objekt asynchron geöffnet, werden alle nachfolgenden Vorgänge (außer dem Überprüfen des State und anderer Eigenschaften) blockiert, bis der Open-Vorgang abgeschlossen ist.
Zusätzlich zu den oben beschriebenen Optionen können Sie, indem Sie source nicht angeben, einfach ein Stream -Objekt im Arbeitsspeicher instanziieren, ohne es einer zugrunde liegenden Quelle zuzuordnen. Sie können dem Datenstrom Daten dynamisch hinzufügen, indem Sie mit Write oder WriteText einfach Binär- oder Textdaten in das Stream -Objekt schreiben, oder indem Sie mithilfe von LoadFromFile Daten aus einer Datei laden.