Freigeben über

SaveToFile-Methode (ADO)

  • Artikel

Gilt für: Access 2013, Office 2013

Speichert den binären Inhalt eines Stream-Objekts in eine Datei.

Syntax

Stream. SaveToFileFileName, SaveOptions

Parameter

Parameter Beschreibung
FileName Ein String -Wert, der den vollqualifiziertern Namen der Datei enthält, in die der Inhalt des Stream -Objekts gespeichert wird. Sie können einen gültigen lokalen Speicherort oder einen Speicherort, auf den Sie über einen UNC-Wert zugreifen können, angeben.
Saveoptions Ein SaveOptionsEnum-Wert, der angibt, ob eine neue Datei mithilfe von SaveToFile erstellt werden soll, falls diese nicht bereits vorhanden ist. Der Standardwert lautet adSaveCreateNotExists. Mit diesen Optionen können Sie angeben, dass ein Fehler auftritt, falls die angegebene Datei nicht vorhanden ist. Sie können auch angeben, dass SaveToFile den aktuellen Inhalt einer vorhandenen Datei überschreibt.

Hinweis

Wenn Sie eine vorhandene Datei überschreiben (wenn adSaveCreateOverwrite festgelegt ist), ignoriert SaveToFile alle Bytes aus der vorhandenen ursprünglichen Datei, die dem neuen EOS folgen.

Hinweise

SaveToFile kann verwendet werden, um den Inhalt eines Stream -Objekts in eine lokale Datei zu speichern. Es werden keine Änderungen am Inhalt oder den Eigenschaften des Stream -Objekts vorgenommen. Das Stream -Objekt muss vor dem Aufrufen von SaveToFile geöffnet werden.

Diese Methode ändert nicht die Zuordnung des Stream-Objekts zur zugrunde liegenden Quelle. Das Stream-Objekt wird weiterhin der ursprünglichen URL oder dem Datensatz zugeordnet, der beim Öffnen seine Quelle war.

Nach einem SaveToFile-Vorgang wird die aktuelle Position (Position) im Datenstrom auf den Anfang des Datenstroms festgelegt (0).