System.WideStrings.TWideStrings.CommaText
Delphi
property CommaText: WideString read GetCommaText write SetCommaText;
C++
__property System::WideString CommaText = {read=GetCommaText, write=SetCommaText};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | public | System.WideStrings.pas System.WideStrings.hpp |
System.WideStrings | TWideStrings |
Beschreibung
Führt die Strings eines TWideStrings-Objekts im SDF-Format (System Data Format) auf.
Mit CommaText ermitteln oder setzen Sie alle Strings in einem TWideStrings-Objekt wie einen einzigen, durch Komma getrennten String.
Wenn die Eigenschaft CommaText abgerufen 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 Strings durch Komma 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 angegeben:
"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 Ausgangs-String ein Komma angefügt, erscheint in der String-Liste ein leerer Eintrag. Ein Beispiel für CommaText:
"String1, String 2, String 3,"
Die String-Liste hat dann folgenden Inhalt:
String1 String2 String3 <Blank>