SaveToFile-Methode

  • Artikel

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.

Gilt für

Stream-Objekt (ADO)

Weitere Informationen

Open-Methode (ADO-Datenstrom)
Save-Methode