System.Classes.TWriter.WriteString

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure WriteString(const Value: string);

C++

void __fastcall WriteString(const System::UnicodeString Value);

Eigenschaften

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


Beschreibung

Schreibt den in Value übergebenen String an den Stream des Writer-Objekts.

WriteString wird intern vom Komponenten-Streaming-System verwendet, um die String-Typ-Eigenschaften von Komponenten an den Stream des Writer-Objekts zu schreiben.

WriteString ruft WriteValue auf, um den Werttypbezeichner (einen der Werte vaString, vaLString, vaWString oder vaUTF8String) an den übergebenen Value-String zu schreiben und ruft dann Write auf, um die übergebenen Value-Stringdaten an den Stream des Writer-Objekts zu schreiben.

WriteString setzt die aktuelle Position nach dem letzten geschriebenen Byte nach vorne.

Warnung: Verwenden Sie immer WriteString, wenn Komponentenstrings in Streams geschrieben werden sollen. Die ähnlich benannten Methoden WriteStr und WriteUTF8Str sind nur für den internen Gebrauch durch bestimmte Komponenten vorgesehen. Ein falscher Einsatz dieser Methoden kann zu fehlerhaften Daten führen.
Hinweis: Bitte beachten Sie, dass der Werttypbezeichner vaString für den Typ ANSIString und der Werttypbezeichner vaLString für den Unicode-Stringtyp gilt, der der Alias des Stringtyps ist.

Siehe auch