System.Classes.TStrings.SaveToStream

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SaveToStream(Stream: TStream); overload; virtual;
procedure SaveToStream(Stream: TStream; Encoding: TEncoding); overload; virtual;

C++

virtual void __fastcall SaveToStream(TStream* Stream)/* overload */;
virtual void __fastcall SaveToStream(TStream* Stream, System::Sysutils::TEncoding* Encoding)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.Classes.pas
System.Classes.hpp
System.Classes TStrings


Beschreibung

Schreibt den Wert der Eigenschaft Text in den Stream Stream.

SaveToStream ruft alle Strings aus dem aktuellen TStrings-Objekt ab und kombiniert sie in einen einzelnen String, der diese Strings, getrennt durch die LineBreak-Sequenz enthält. Dann codiert SaveToStream diesen String anhand der angegebenen Codierung (Encoding). Anschließend schreibt SaveToStream den codierten String in den angegebenen Stream Stream.
Wenn WriteBOM True ist, dann ruft SaveToStream zuerst die Präambel der angegebenen Encoding oder der DefaultEncoding ab (wenn Encoding = nil) und schreibt die Präambel-Bytes vor dem Hauptstring in den Stream.
Wenn der Parameter Encoding nicht angegeben ist, werden die Strings mit der Codierung gespeichert, die in der Eigenschaft Encoding angegeben ist.

Hinweis: In Windows ist der Standardwert für LineBreak eine Kombination aus dem Wagenrücklauf- und dem Zeilenvorschubzeichen (#13#10). In macOS wird nur das Zeilenvorschubzeichen (#10) verwendet.
Hinweis: Wenn TrailingLineBreak True ist, dann schreibt SaveToStream nach dem letzten String ein abschließendes Zeilenumbruchzeichen LineBreak.

Handelt es sich bei dem Stream um einen Datei-Stream, so hat SaveToStream die gleiche Wirkung wie SaveToFile. Ein Unterschied besteht jedoch darin, dass SaveToFile den Stream erzeugt und später wieder freigibt.

Siehe auch

Codebeispiele