最終更新日 :
2021年4月28日
説明
Excel スプレッドシートオブジェクトセルの値を指定します。
カテゴリ
Microsoft Office の統合
関数のシンタックス
SpreadsheetSetCellValue(spreadsheetObj, value, row, column, datatype) |
関連項目
SpreadsheetGetCellComment、SpreadsheetFormatCell、SpreadsheetGetCellFormula、SpreadsheetGetCellValue、
SpreadsheetMergeCells、SpreadsheetSetCellComment、SpreadsheetSetCellFormula
履歴
ColdFusion 11：datatype 属性が追加されました。
ColdFusion 9：この関数が追加されました。
パラメーター
パラメーター |
説明 |
|---|---|
spreadsheetObj |
コメントの追加先となる Excel スプレッドシートオブジェクトです。 |
value |
セルの値を含む文字列です。 |
row |
値を設定するセルの行番号です。 |
column |
値を設定するセルの列番号です。 |
| datatype | セルの値のデータタイプです。データタイプは String、Date、Numeric です。 |
例
次の例では、Excel スプレッドシートオブジェクトを作成して、行 3 列 5 のセルの値を 365 に設定し、その値を取得します。
| <cfscript> //Create a new Excel spreadsheet object. theSheet=SpreadsheetNew(); //Set the value of the cell at row 3 column 5. SpreadsheetSetCellValue(theSheet,365,3,5); //Get the value from the Excel spreadsheet object. theValue=SpreadsheetGetCellValue(theSheet,3,5); WriteOutput("The value of column 5 row 3 is: " & theValue); </cfscript> |
例 2 | datatype パラメーターの使用
<cfscript>
// create a query with data to write an excel file.
q_data = QueryNew("n1, n2, n3, s4, s5, d6", "",
[
{n1:"1.203E+4", n2:"1.230E4", n3:"103E4", s4:"1.203E+4", s5:"1.230E4", d6:"4 jan 15"},
{n1:"1.203E+4", n2:"1.230E4", n3:"103E4", s4:"01.203E+4", s5:"9.230E4", d6:"15 dec 15"}
]);
cfdump(var="#q_data#", format="html", label="qry-data");
datatype_arr = ["NUMERIC:1-3; STRING:4,5; DATE:6","STRING:1-3; NUMERIC:4,5; STRING:6"];
/*//////////////////// spreadSheetSetCellValue method : datatype parameter. ////////////////////*/
/*// method signature : SpreadsheetSetCellValue(spreadsheetObj, value, row, column, datatype) //*/
qry_xl_fl = expandpath("./") & "setcl-dt-ty_qry.xlsx";
xl_obj = spreadsheetNew("test-setcel-dty", true);
q_cl_lst = listsort(q_data.columnlist, "TextNoCase", "DESC");
for( r=1; r LTE q_data.recordcount; r++){
for(c=1; c LTE listLen(q_cl_lst); c++)
{
col_name = listGetAt(q_cl_lst, c);
if(col_name CONTAINS "d")
spreadSheetSetCellValue(xl_obj, q_data[col_name][r], r, c, "DATE" );
else if(col_name CONTAINS "n")
spreadSheetSetCellValue(xl_obj, q_data[col_name][r], r, c, "NUMERIC" );
else
spreadSheetSetCellValue(xl_obj, q_data[col_name][r], r, c, "STRING" );
}
}
spreadsheetwrite(xl_obj, qry_xl_fl, "", true, datatype_arr); //pass an empty str for password parameter.
cfspreadsheet( action="read", src=qry_xl_fl, query="q_data_out");
cfdump(var="#q_data_out#", format="html", label="data-read-from-setcl-xl");
</cfscript>
