System.WideStrings.TWideStrings.DelimitedText

提供:RAD Studio API Documentation

Delphi

property DelimitedText: WideString read GetDelimitedText write SetDelimitedText;

C++

__property System::WideString DelimitedText = {read=GetDelimitedText, write=SetDelimitedText};

プロパティ

種類 可視性 ソース ユニット 親
property public
System.WideStrings.pas
System.WideStrings.hpp
System.WideStrings TWideStrings

説明

TWideStrings オブジェクト内のすべての文字列を、区切り記号で区切られた単一の文字列として表します。

DelimitedText を使用すると、TWideStrings オブジェクト内のすべての文字列を Delimiter プロパティで指定された文字で区切られた単一の文字列として取得または設定することができます。

DelimitedText を取得する場合、Delimiter および QuoteChar プロパティで指定されたスペース、区切り文字、または引用符文字を含むリストの文字列は引用符文字(QuoteCha)で前後を囲まれています。また、個々の文字列に含まれる QuoteChar 文字は繰り返されます。

DelimitedText を取得する場合、結果として得られる文字列値では個々の文字列が 2 とおりの方法のいずれかで区切られます。第 1 に、それぞれの文字列を QuoteChar プロパティで指定された引用符文字で前後を囲みます。第 2 は、Delimiter プロパティで指定されている文字で個々の文字列を区切る方法です。

DelimitedText に代入する場合は、Delimiter を区切り記号として使用するか、また、オプションで QuoteChar 文字で囲んでもかまいません。

DelimitedText に代入する場合、その値は SDF 形式のテキストとして解析されます。SDF 形式では、文字列は Delimiter 文字またはスペースで区切られています。また、オプションで QuoteChar 文字で囲んでもかまいません。文字列の一部となっている二重引用符 QuoteChar は、文字列を囲むための引用符 QuoteChar 文字と区別するために繰り返されます。Delimiter 符の中に含まれないスペースと QuoteChar 文字は、区切り文字になります。2 つの Delimiter 文字が隣り合っている場合は、空の文字列を表します。ただし、別の Delimiter 文字の隣にあるスペースは、無視されます。

StrictDelimiter が False に設定されている場合は、Delimiter の値にかかわらず、スペース文字も区切り文字として解釈されます。ただし、これは、引用符の間にスペース文字が現れる場合には当てはまりません。

メモ:Delimiter が ',' で QuoteChar が '"' の場合、CommaText は DelimitedText プロパティと同じになります。ソース文字列の末尾に Delimiter が含まれる場合は、文字列リストに空白の項目が含まれる結果になります。

関連項目