SpreadsheetWrite

説明

ColdFusion スプレッドシートオブジェクトから新しい XLS ファイルに 1 つのシートを書き込みます。

カテゴリ

Microsoft Office の統合

関数のシンタックス

SpreadSheetWrite(SpreadsheetObj, fileName) 
SpreadSheetWrite(SpreadsheetObj, fileName [,overwrite]) 
SpreadSheetWrite(SpreadsheetObj, fileName [, password]) 
SpreadSheetWrite(SpreadsheetObj, fileName [, password,overwrite])

履歴

ColdFusion 9: この関数が追加されました。

パラメータ

パラメータ

説明

spreadSheetObj

書き込み対象の Excel スプレッドシートオブジェクトです。

fileName

書き込まれるファイルのパス名です。

overwrite

既存のファイルを上書きするかどうかを指定するブール値です。上書きする場合は yes を指定します。

password

アクティブシートを保護するためのパスワードです。パスワードは Excel 97 ~ 2003 のファイル形式のみに適用されます。XML ファイル形式 (Excel 2007) の場合は無視されます。

使用方法

この関数は次のような目的に使用できます。

  • 複数のシートを 1 つのファイルに書き込む。

  • 既存のファイルを更新し、ファイル内のすべてのシートを読み取り、1 つまたは複数のシートを変更し、ファイル全体を再度書き込む。

<cfscript>     
    spreadsheet = SpreadSheetRead("C:\Files\Report.xls","Annual Report"); 
    SpreadSheetWrite(spreadsheet,"C:\Files\Report.xls","P@ssword","yes"); 
</cfscript>

例 2

<cfscript> 
        spObj = spreadsheetread("#dirname#SingleSheet.xls","Sheet2"); 
        spreadsheetCreateSheet(spObj,"A"); 
        spreadsheetaddrow(spObj,"x,x,x,x,x",3,1); 
        spreadsheetsetActiveSheet(spObj,"A"); 
        spreadsheetaddrow(spObj,"z,z,z,z,z",3,1); 
        spreadsheetsetActiveSheetNumber(spObj,1); 
        spreadsheetaddrow(spObj,"a,b,c,d,e",3,1); 
        SpreadsheetWrite(spObj,"#dirname#SingleSheet1.xls","yes"); 
</cfscript>