設計用于 CSV 輸出

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

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

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

PageHeaderPageFooterCustomLineImageActiveXControl

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

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

項 呈現行為

文本框

呈現文本框的內容。數據的格式按照該項的 Format 屬性設置。

表

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

矩陣

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

列表

為列表中每一明細行或實例呈現一個記錄。

矩形

將子報表的內容呈現為嵌套項。對于內容的每個實例，都會重復它的父項。

子報表

將子報表的內容呈現為嵌套項。對于內容的每個實例，都會重復它的父項。

圖表

為一組數據值呈現一行，為另一組數據值呈現多列。

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

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