設計用于 CSV 輸出

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

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

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

PageHeaderPageFooterCustomLineImageActiveXControl

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

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

項 呈現(xiàn)行為

文本框

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

表

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

矩陣

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

列表

為列表中每一明細行或實例呈現(xiàn)一個記錄。

矩形

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

子報表

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

圖表

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

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

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