Importe un fichier ou flux texte CSV ou TSV dans une feuille de calcul d'un classeur
TXLSWorkbook.OpenCSV fournit le point d'entrée de la façade XLS classique,
et TXLSXWorkbook.OpenCSV offre le même comportement d'import
pour la façade XLSX
Syntaxe
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. Chemin complet ou relatif du fichier texte délimité |
| Stream |
TStream. Données CSV ou TSV complètes à importer |
| ASeparator |
WideChar. Utilisez #0 pour détecter automatiquement virgule, point-virgule, tabulation ou barre verticale dans la première ligne renseignée ; sinon passez le séparateur à utiliser |
| ADetectTypes |
Boolean. À True, les champs sont promus en variants numériques, date/heure ou booléens quand c'est possible. À False, les champs restent du texte, ce qui est utile pour les zéros de tête et les identifiants longs |
| AOptions |
TXlsCsvImportOptions. Utilisez TXlsCsvImportOptions.Default pour des valeurs par défaut déterministes sur tous les compilateurs pris en charge, puis définissez Separator, DetectTypes, SkipRows ou AutoTrim selon les besoins |
Comportement
L'importateur détecte les marques d'ordre d'octets UTF-8 et UTF-16, analyse les champs
entre guillemets à la RFC 4180, et écrit la grille analysée dans une feuille de calcul
Appeler Open(FileName) sur un chemin .csv ou
.tsv bascule automatiquement vers cet importateur
Exemple
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);
Voir aussi