System.Classes.TStrings.DelimitedText
Delphi
property DelimitedText: string read GetDelimitedText write SetDelimitedText;
C++
__property System::UnicodeString DelimitedText = {read=GetDelimitedText, write=SetDelimitedText};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStrings |
Description
Représente toutes les chaînes de l'objet TStrings comme une seule chaîne délimitée.
Utilisez DelimitedText pour obtenir ou définir toutes les chaînes de l'objet TStrings sous forme d'une seule chaîne, séparée par le caractère spécifié par la propriété Delimiter.
Lors de la récupération de DelimitedText, chaque chaîne de la liste qui inclut d'espaces ou le délimiteur et les caractères guillemets spécifiés dans les propriétés Delimiter et QuoteChar sera entourée (avant et après) du caractère guillemet (QuoteChar). De plus, tout caractère QuoteChar contenu dans une chaîne individuelle sera répétée.
Lors de la récupération de DelimitedText, la valeur résultante délimite les chaînes individuelles de deux façons : chaque chaîne est entourée (avant et après) du caractère guillemet spécifié par la propriété QuoteChar. De plus, les chaînes individuelles sont séparées par le caractère spécifié par la propriété Delimiter.
Lors de l'affectation de la propriété DelimitedText, les chaînes individuelles doivent être séparées en utilisant des marques Delimiter et facultativement placées entre des caractères QuoteChar.
Lors de l'affectation de DelimitedText, 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 caractères Delimiter ou des espaces et, de manière facultative, placées entre des caractères QuoteChar. Les guillemets placés à l'intérieur des chaînes sont répétés afin de les distinguer des caractères QuoteChar encadrant la chaîne. Les espaces et les caractères Delimiter ne se trouvant pas entre des guillemets sont des délimiteurs. Deux caractères Delimiter successifs indiquent une chaîne vide, alors que les espaces à côté d'un caractère Delimiter ne sont pas pris en compte.
Si StrictDelimiter est définie sur False, le caractère espace est aussi interprété comme un délimiteur, quelle que soit la valeur de Delimiter. Cela n'est pas vrai quand le caractère espace se trouve entre guillemets.
Remarque : CommaText est équivalent à la propriété DelimitedText quand Delimiter vaut ‘,’ et QuoteChar vaut ‘"’. L'ajout d'un Delimiter à la fin de la chaîne source provoque l'inclusion d'un élément vide dans la liste de chaînes.