System.Classes.TStrings.CommaText
Delphi
property CommaText: string read GetCommaText write SetCommaText;
C++
__property System::UnicodeString CommaText = {read=GetCommaText, write=SetCommaText};
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
property | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStrings |
Beschreibung
Führt die Strings eines TStrings-Objekts auf. Sie wird im SDF-Format (System Data Format) dargestellt.
Die Eigenschaft CommaText bietet beim Schreiben oder Lesen die Möglichkeit, sämtliche Listeneinträge eines Objekts von TStrings wie einen einzigen, durch Kommas getrennten String zu behandeln.
Wenn die Eigenschaft CommaText gelesen wird, gelten folgende Konventionen: Jeder Eintrag der String-Liste, der Leerzeichen, Kommas oder Anführungszeichen enthält, wird in Anführungszeichen (") gesetzt. Ist ein Anführungszeichen (") selbst Teil eines Strings, wird es verdoppelt. Ein Beispiel: Die String-Liste
Stri,ng 1 Stri"ng 2 String 3 String4
wird von der Eigenschaft CommaText in der folgenden Form zurückgegeben:
"Stri,ng 1","Stri""ng 2","String 3",String4
Wenn eine Wertzuweisung an CommaText erfolgt, wird der Wert entsprechend dem SDF-Format zerlegt. Dies setzt voraus, dass Zeichenketten durch Kommas oder Leerzeichen getrennt und optional in Anführungszeichen eingeschlossen sind. Anführungszeichen, die Teil des Strings sind, müssen zweimal hintereinander stehen (""), sonst werden sie als Begrenzungszeichen interpretiert. Leerzeichen und Kommas, die nicht von Anführungszeichen eingeschlossen sind, werden als Trennzeichen behandelt. Zwei aufeinander folgende Kommas gelten als Leer-String. Leerzeichen, die unmittelbar vor oder nach einem Trennzeichen stehen, werden dagegen ignoriert. Angenommen, CommaText wird folgendermaßen gesetzt:
"Stri,ng 1", "Stri""ng 2" , String 3,String4
Die String-Liste enthält danach folgende Einträge:
Stri,ng 1 Stri"ng 2 String 3 String4
Anmerkung: Die Eigenschaft CommaText entspricht der Eigenschaft DelimitedText, wenn diese mit einem Komma als Trennzeichen und dem Zeichen " als Anführungszeichen verwendet wird.
Wird an den Ausgangsstring ein Komma angefügt, erscheint in der Stringliste ein leerer Eintrag. Ein Beispiel für CommaText:
"String1, String 2, String 3,"
Die Stringliste hat dann folgenden Inhalt:
String1 String2 String3 <Blank>