System.Classes.TStrings.LoadFromStream

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

virtual void __fastcall LoadFromStream(TStream* Stream)/* overload */;
virtual void __fastcall LoadFromStream(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

Füllt die Liste mit Textzeilen, die aus einem Stream gelesen werden.

Mit der Methode LoadFromStream wird die String-Liste eines TStrings-Objekts mit Strings aus einem Stream gefüllt. Der aus dem Stream gelesene Text wird in einzelne Strings zerlegt, wobei Zeilenvorschub- oder Wagenrücklaufzeichen als Trennzeichen interpretiert werden. Die Methode LoadFromStream dient also dazu, den Wert der Eigenschaft Text zu lesen.

Wenn der Parameter Encoding nicht angegeben ist, werden die Strings mit der geeigneten Codierung geladen. Der Wert der Codierung wird anhand des Aufrufs der Routine GetBufferEncoding der Klasse TEncoding ermittelt. Danach speichert LoadFromFile den Wert der Codierung in die Eigenschaft Encoding, um ihn beim Speichern der Datei zu verwenden.

Handelt es sich bei dem Stream um einen Datei-Stream, dann führen die Methoden LoadFromStream und LoadFromFile zum gleichen Ergebnis. Ein Unterschied besteht jedoch darin, dass das Programm beim Einsatz von LoadFromStream den Stream zuerst erzeugen und später wieder freigeben muss.

Siehe auch

Codebeispiele