System.Classes.TStrings.CommaText
Delphi
property CommaText: string read GetCommaText write SetCommaText;
C++
__property System::UnicodeString CommaText = {read=GetCommaText, write=SetCommaText};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
property | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStrings |
Description
Dresse la liste des chaînes dans l'objet TStrings dans une seule chaîne délimitée par des virgules.
Utilisez CommaText pour obtenir ou définir l'ensemble des chaînes de l'objet TStrings dans une seule chaîne délimitée par des virgules. Ce format de chaîne unique délimitée par des virgules se nomme également format de données système (SDF).
En récupérant CommaText, toute chaîne de la liste contenant des espaces, des virgules ou des apostrophes est placée entre guillemets; les guillemets à l'intérieur des chaînes sont répétés. Par exemple, si la liste contient les chaînes suivantes :
Stri,ng1 Stri"ng2 String 3 String4
CommaText renvoie :
"Stri,ng1","Stri""ng2","String 3",String4
Lors de l'assignation d'une valeur à CommaText, la valeur est analysée en tant que texte au format SDF. Dans le format SDF, les chaînes sont séparées par des virgules ou des espaces, et facultativement délimitées par des guillemets. Les guillemets placés à l'intérieur des chaînes sont répétés pour les distinguer des guillemets encadrant la chaîne. Les espaces et les virgules non contenus entre des guillemets sont des délimiteurs. Deux virgules successives indiquent une chaîne vide, alors que des espaces à côté d'un délimiteur ne sont pas pris en compte. Par exemple, supposons que CommaText soit défini sur :
"Stri,ng 1","Stri""ng 2",String 3,String4
La liste contient alors :
Stri,ng 1 Stri"ng 2 String 3 String4
Remarque : CommaText est équivalent à la propriété DelimitedText avec ‘,’ comme délimiteur et ‘"’ comme caractère guillemet.
L'ajout d'une virgule à la fin de la chaîne source provoque l'inclusion d'un élément vide dans la liste de chaînes. Par exemple, si CommaText est défini sur
"String1,String2,String3, "
la liste de chaînes contiendra :
String1 String2 String3 <Blank>