Importiert eine CSV- oder TSV-Textdatei oder einen Stream in ein Arbeitsmappen-Tabellenblatt
TXLSWorkbook.OpenCSV bietet den klassischen XLS-Fassaden-Einstiegspunkt und TXLSXWorkbook.OpenCSV bietet den XLSX-Einstiegspunkt; beide schreiben in das angegebene oder erste Tabellenblatt der Arbeitsmappe
Syntax
function OpenCSV(FileName: WideString): Integer;
function OpenCSV(FileName: WideString; ASeparator: WideChar; ADetectTypes: Boolean): Integer;
function OpenCSV(Stream: TStream): Integer;
function OpenCSV(Stream: TStream; ASeparator: WideChar; ADetectTypes: Boolean): Integer;
function OpenCSV(const FileName: WideString; const AOptions: TXlsCsvImportOptions): Integer;
function OpenCSV(Stream: TStream; const AOptions: TXlsCsvImportOptions): Integer;
| FileName |
WideString. Vollständiger oder relativer Pfad zur durch Trennzeichen getrennten Textdatei |
| Stream |
TStream. Vollständige CSV- oder TSV-Daten zum Import |
| ASeparator |
WideChar. Verwenden Sie #0, um Komma, Semikolon, Tabulator oder Pipe anhand der ersten gefüllten Zeile automatisch zu erkennen; andernfalls übergeben Sie das zu verwendende Trennzeichen |
| ADetectTypes |
Boolean. Wenn True, werden Felder nach Möglichkeit in numerische, Datum/Uhrzeit- oder Boolesche Varianten hochgestuft. Wenn False, bleiben Felder Text, was für führende Nullen und lange Bezeichner nützlich ist |
| AOptions |
TXlsCsvImportOptions. Verwenden Sie TXlsCsvImportOptions.Default für deterministische Standardwerte auf jedem unterstützten Compiler und setzen Sie dann bei Bedarf Separator, DetectTypes, SkipRows oder AutoTrim |
Verhalten
Der Importer erkennt UTF-8- und UTF-16-Byte-Order-Marks, parst RFC 4180-konforme Felder in Anführungszeichen und schreibt das geparste Raster in ein Tabellenblatt
Der Aufruf von Open(FileName) mit einem .csv- oder .tsv-Pfad leitet automatisch an diesen Importer weiter
Beispiel
Workbook.OpenCSV('orders.csv');
Workbook.OpenCSV('part-numbers.tsv', #9, False);
Options := TXlsCsvImportOptions.Default;
Options.SkipRows := 1;
Options.AutoTrim := True;
Workbook.OpenCSV('orders-with-heading.csv', Options);
Siehe auch