設(shè)計(jì)用于 CSV 輸出

逗號(hào)分隔值 (CSV) 呈現(xiàn)擴(kuò)展插件以逗號(hào)分隔的純文本文件形式呈現(xiàn)報(bào)表，而不帶有任何格式。它使用字符串分隔符來分隔字段和行，其中字符串分隔符可以配置為除逗號(hào)之外的字符。最終文件可以用電子表格程序（如 Microsoft Excel）打開，也可以用作其他程序的導(dǎo)入格式。所導(dǎo)出的報(bào)表會(huì)變?yōu)?.csv 文件，并返回 MIME 類型的 text/plain。這種 .csv 文件為 MIME 1.0 版文件。 當(dāng)使用默認(rèn)設(shè)置進(jìn)行呈現(xiàn)時(shí)，CSV 報(bào)表具有以下特征：

第一條記錄包含報(bào)表中所有列的標(biāo)題。所有行的列數(shù)都相同。默認(rèn)字段分隔符字符串是逗號(hào) (,)。記錄分隔符字符串是回車符和換行符 (<cr><lf>)。文本限定符字符串是引號(hào) (')。如果文本包含嵌入的分隔符字符串或限定符字符串，則會(huì)用文本限定符（引號(hào)）將該文本括起來，還將嵌入的限定符字符串（引號(hào)）用引號(hào)引起來。忽略格式設(shè)置和布局。

在呈現(xiàn)報(bào)表時(shí)，CSV 呈現(xiàn)擴(kuò)展插件會(huì)迭代報(bào)表處理器生成的報(bào)表對(duì)象模型。在處理期間忽略以下元素：

PageHeaderPageFooterCustomLineImageActiveXControl

并對(duì)其余的報(bào)表項(xiàng)進(jìn)行排序，先從上到下排，再從左到右排。之后，每一項(xiàng)將呈現(xiàn)到一列中。如果報(bào)表有嵌套數(shù)據(jù)項(xiàng)（如列表或表），則會(huì)在每條記錄中重復(fù)它的父項(xiàng)。

下表列出了各個(gè)項(xiàng)呈現(xiàn)到 CSV 時(shí)有關(guān)它們的注意事項(xiàng)：

項(xiàng) 呈現(xiàn)行為

文本框

呈現(xiàn)文本框的內(nèi)容。數(shù)據(jù)的格式按照該項(xiàng)的 Format 屬性設(shè)置。

表

呈現(xiàn)方式為擴(kuò)展該表，在只保留最起碼的格式的情況下為每一行和每一列都分別創(chuàng)建行和列。小計(jì)行和小計(jì)列沒有列標(biāo)題或行標(biāo)題。不支持鉆取報(bào)表。

矩陣

呈現(xiàn)方式為擴(kuò)展該矩陣，在只保留最起碼的格式的情況下為每一行和每一列都分別創(chuàng)建行和列。小計(jì)行和小計(jì)列沒有列標(biāo)題或行標(biāo)題。

列表

為列表中每一明細(xì)行或?qū)嵗尸F(xiàn)一個(gè)記錄。

矩形

將子報(bào)表的內(nèi)容呈現(xiàn)為嵌套項(xiàng)。對(duì)于內(nèi)容的每個(gè)實(shí)例，都會(huì)重復(fù)它的父項(xiàng)。

子報(bào)表

將子報(bào)表的內(nèi)容呈現(xiàn)為嵌套項(xiàng)。對(duì)于內(nèi)容的每個(gè)實(shí)例，都會(huì)重復(fù)它的父項(xiàng)。

圖表

為一組數(shù)據(jù)值呈現(xiàn)一行，為另一組數(shù)據(jù)值呈現(xiàn)多列。

對(duì)于幾個(gè)可配置的設(shè)備信息設(shè)置（如哪些字符將用作字段分隔符、記錄分隔符和限定符），CSV 呈現(xiàn)擴(kuò)展插件均使用這些設(shè)置的默認(rèn)值。這些設(shè)備信息設(shè)置可以通過自定義應(yīng)用程序來訪問和更改，并且您可以通過使用設(shè)備信息設(shè)置來控制數(shù)據(jù)、默認(rèn)分隔符和分頁符的呈現(xiàn)。可以使用 FieldDelimiter、RecordDelimiter 和 Qualifier 設(shè)備信息設(shè)置來更改字段分隔符、記錄分隔符和文本限定符。

為了控制分頁符，則可以使用 SuppressLineBreaks 設(shè)置來控制，它的值是一個(gè)布爾值，指定呈現(xiàn)數(shù)據(jù)時(shí)是否刪除換行符。如果 SuppressLineBreaks 為 true，則換行符和回車符就由一個(gè)空格替代。Extension 設(shè)置用于指定文本文件的文件擴(kuò)展名；Encoding 設(shè)置用于將編碼從默認(rèn)的 Unicode 更改為 ASCII、UTF-7 或 UTF-8。最后，NoHeader 設(shè)置指示在呈現(xiàn)報(bào)表時(shí)是否省略表頭行。