Importerar en CSV- eller TSV-textfil eller -ström till ett kalkylblad i arbetsboken
TXLSWorkbook.OpenCSV är startpunkten i det klassiska XLS-fasadet,
och TXLSXWorkbook.OpenCSV ger samma importbeteende i
XLSX-fasadet
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. Fullständig eller relativ sökväg till den avgränsade textfilen |
| Stream |
TStream. Kompletta CSV- eller TSV-data som ska importeras |
| ASeparator |
WideChar. Använd #0 för att automatiskt identifiera komma, semikolon, tabb eller pipe från första ifyllda rad; annars anger du vilken avgränsare som ska användas |
| ADetectTypes |
Boolean. När True konverteras fält till numeriska variant, datum/tid eller Boolean där det är möjligt. När False lämnas fält som text, vilket är praktiskt för inledande nollor och långa identifierare |
| AOptions |
TXlsCsvImportOptions. Använd TXlsCsvImportOptions.Default för deterministiska standardvärden i alla stödda kompilatorer och sätt därefter Separator, DetectTypes, SkipRows eller AutoTrim efter behov |
Beteende
Importeraren känner igen UTF-8- och UTF-16-byte-ordningsmarkeringar, tolkar
RFC 4180-liknande citerade fält och skriver den tolkade rutnätet till ett kalkylblad
Anrop av Open(FileName) med en .csv- eller
.tsv-sökväg dirigeras automatiskt till denna importör
Exempel
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);
Se även