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
Enumère les chaînes de l'objet TStrings en utilisant le format de données système (SDF).
La propriété CommaText permet de définir ou d'obtenir toutes les chaînes de l'objet TStrings dans une seule chaîne délimitée par des virgules.
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:
Chai,ne 1 Chai"ne 2 Chaine 3 Chaine4
CommaText renvoie :
"Chai,ne 1","Chai""ne 2","Chaine 3",Chaine4
Lorsqu'une valeur est affectée à CommaText, la valeur est analysée comme une chaîne utilisant le format SDF. Dans le format SDF, les chaînes sont séparées par des virgules ou des espaces et, de manière facultative, mises entre guillemets. Les guillemets placés à l'intérieur des chaînes sont répétés afin de les distinguer des guillemets encadrant la chaîne. Les espaces et les virgules ne se trouvant pas 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. Si, par exemple, la valeur suivante est affectée à CommaText :
"Chai,ne 1", "Chai""ne 2" , Chaine 3,Chaine4
La liste contient alors:
Chai,ne 1 Chai"ne 2 Chaîne 3 Chaine4
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éfinie par :
"Chaine1, Chaine 2, Chaine 3,"
la liste de chaînes contiendra :
Chaine1 Chaine2 Chaine3 <Vide>