OpenCSV 方法 - HotXLS 開發者參考

將 CSV 或 TSV 文字檔或串流匯入活頁簿工作表 TXLSWorkbook.OpenCSV 提供傳統 XLS 外觀的進入點， TXLSXWorkbook.OpenCSV 則為 XLSX 外觀提供相同的匯入行為

語法

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。分隔文字檔的完整或相對路徑
Stream	TStream。要匯入的完整 CSV 或 TSV 資料
ASeparator	WideChar。傳 `#0` 會從第一個有內容的行自動偵測逗號、分號、定位字元或管線符號；否則請直接傳入要使用的分隔符號
ADetectTypes	Boolean。設為 `True` 時，欄位會在可能的情況下提升為數值、日期／時間或布林 variant。設為 `False` 時欄位維持文字，適合用在前導零與長識別碼的場合
AOptions	`TXlsCsvImportOptions`。先用 `TXlsCsvImportOptions.Default` 取得在每個支援編譯器上都一致的預設值，再視需要設定 `Separator`、`DetectTypes`、`SkipRows` 或 `AutoTrim`

行為

匯入器會偵測 UTF-8 與 UTF-16 位元組順序記號（BOM），剖析 RFC 4180 風格的帶引號欄位，並把剖析後的網格寫入工作表對 .csv 或 .tsv 路徑呼叫 Open(FileName) 時，會自動改走這個匯入器

範例

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);

另請參閱

IXLSWorkbook.Open 方法
IXLSWorkbook.SaveAsCSV 方法
TXLSXWorkbook 類別