SaveToFile-Methode
Speichert den binären Inhalt eines Streams in einer Datei.
Syntax
Stream.SaveToFile FileName, SaveOptions
Parameter
FileName
Ein String-Wert, der den vollqualifizierten Namen der Datei enthält, in der der Inhalt des Streams gespeichert wird. Sie können an jedem gültigen lokalen Speicherort oder einem beliebigen Ort speichern, auf den Sie über einen UNC-Wert zugreifen können.
SaveOptions
Ein SaveOptionsEnum-Wert, der angibt, ob eine neue Datei von SaveToFile erstellt werden soll, wenn sie noch nicht vorhanden ist. Der Standardwert ist adSaveCreateNotExists. Mit diesen Optionen können Sie angeben, dass ein Fehler auftritt, wenn 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), schneidet SaveToFile alle Bytes der ursprünglichen vorhandenen Datei ab, die auf den neuen EOS folgen.
Bemerkungen
SaveToFile kann verwendet werden, um den Inhalt eines Stream-Objekts in eine lokale Datei zu kopieren. Der Inhalt oder die Eigenschaften des Stream-Objekts werden nicht geändert. Das Stream-Objekt muss geöffnet sein, bevor SaveToFile aufgerufen wird.
Diese Methode ändert die Zuordnung des Stream-Objekts zu seiner zugrunde liegenden Quelle nicht. Das Stream-Objekt ist weiterhin der ursprünglichen URL oder dem ursprünglichen Record zugeordnet, die/der beim Öffnen seine Quelle war.
Nach einem SaveToFile-Vorgang wird die aktuelle Position (Position) im Stream auf den Anfang des Streams (0) festgelegt.