ColdFusion 2021：如何遍历电子表格对象并转换为CSV？

针对你提出的三个问题，以下是适配ColdFusion 2021的具体解决方案：

1. 获取电子表格的行列数 #

使用SpreadsheetInfo()函数可以直接获取电子表格的核心元数据，包括有效行列数。该函数返回一个结构体，其中包含rowCount（总行数）、columnCount（总列数）以及usedRange（实际使用的单元格范围）等字段。示例代码：

<cfset spreadsheetObj = SpreadsheetNew("MySheet")>
<!-- 假设已向表格中添加数据 -->
<cfset sheetInfo = SpreadsheetInfo(spreadsheetObj)>
<cfset totalRows = sheetInfo.rowCount>
<cfset totalCols = sheetInfo.columnCount>

<!-- 遍历所有单元格示例 -->
<cfloop from="1" to="#totalRows#" index="rowNum">
    <cfloop from="1" to="#totalCols#" index="colNum">
        <cfset cellValue = SpreadsheetGetCellValue(spreadsheetObj, rowNum, colNum)>
        <!-- 处理单元格值 -->
    </cfloop>
</cfloop>

2. 遍历表格的其他方式 #

除了通过行列数循环调用SpreadsheetGetCellValue，可以使用SpreadsheetReadRows()函数直接将整个表格转换为二维数组，数组的每个元素对应一行数据，每行又是一个包含单元格值的一维数组。这种方式更简洁高效：

<cfset spreadsheetObj = SpreadsheetNew("MySheet")>
<!-- 假设已向表格中添加数据 -->
<cfset allRows = SpreadsheetReadRows(spreadsheetObj)>

<cfloop array="#allRows#" index="currentRow">
    <cfloop array="#currentRow#" index="cellValue">
        <!-- 处理单元格值 -->
    </cfloop>
</cfloop>

3. 直接将电子表格转换为CSV（无需手动遍历） #

ColdFusion 2021的SpreadsheetWrite()函数原生支持直接导出为CSV格式，无需手动构建内容。只需在调用时指定format参数为"csv"即可，同时可以设置编码、是否包含表头等参数：

<cfset spreadsheetObj = SpreadsheetNew("MySheet")>
<!-- 假设已向表格中添加数据 -->

<!-- 导出到服务器路径 -->
<cfset SpreadsheetWrite(
    spreadsheetObj,
    "C:/temp/output.csv",
    true, <!-- 是否包含表头（如果第一行是表头） -->
    "UTF-8", <!-- 文件编码 -->
    "csv" <!-- 输出格式 -->
)>

内容的提问来源于stack exchange，提问作者Joel Niemelä