Importuje plik tekstowy CSV lub TSV lub strumień do arkusza skoroszytu. TXLSWorkbook.OpenCSV udostępnia klasyczny punkt wejścia fasady XLS, a TXLSXWorkbook.OpenCSV zapewnia takie samo zachowanie importu dla fasady XLSX
Składnia
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. Pełna lub względna ścieżka do pliku tekstowego z ogranicznikami |
| Stream |
TStream. Complete CSV lub TSV data do import |
| ASeparator |
WideChar. Użyj #0, aby automatycznie wykryć przecinek, średnik, tabulator lub pionową kreskę z pierwszej wypełnionej linii; w przeciwnym razie przekaż separator, którego należy użyć |
| ADetectTypes |
Boolean. Gdy True, pola są w miarę możliwości promowane do wariantów liczbowych, daty/czasu lub Boolean. Gdy False, pola pozostają tekstem, co jest przydatne dla wiodących zer i długich identyfikatorów |
| AOptions |
TXlsCsvImportOptions. Użyj TXlsCsvImportOptions.Default, aby uzyskać deterministyczne wartości domyślne na każdym wspieranym kompilatorze, a następnie w razie potrzeby ustaw Separator, DetectTypes, SkipRows lub AutoTrim |
Opis
Importer wykrywa znaczniki kolejności bajtów UTF-8 i UTF-16, analizuje pola cytowane w stylu RFC 4180 i zapisuje przeanalizowaną siatkę do arkusza. Wywołanie Open(FileName) na ścieżce .csv lub .tsv automatycznie kieruje do tego importera
Przykład
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);
Zobacz także