設(shè)計用于 CSV 輸出

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

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

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

PageHeaderPageFooterCustomLineImageActiveXControl

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

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

項 呈現(xiàn)行為

文本框

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

表

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

矩陣

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

列表

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

矩形

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

子報表

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

圖表

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

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

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