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 durch Kommata getrennt dargestellt.
Mit CommaText erhalten oder setzen Sie alle Strings aus dem TStrings-Objekt als ein durch Kommata getrennten String. Das durch Kommata getrenntes String-Format ist auch als SDF-Format (System Data Format) bekannt.
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,ng1 Stri"ng2 String 3 String4
wird von der Eigenschaft CommaText in der folgenden Form zurückgegeben:
"Stri,ng1","Stri""ng2","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
Hinweis: Die Eigenschaft CommaText entspricht der Eigenschaft DelimitedText, wenn diese mit einem Komma als Trennzeichen und dem Zeichen " als Anführungszeichen verwendet wird.
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:
"String1,String2,String3, "
Die Stringliste hat dann folgenden Inhalt:
String1 String2 String3 <Blank>