説明

Excel スプレッドシートオブジェクトセルの値を指定します。

カテゴリ

Microsoft Office の統合

関数のシンタックス

SpreadsheetSetCellValue(spreadsheetObj, value, row, column, datatype)

関連項目

SpreadsheetGetCellCommentSpreadsheetFormatCellSpreadsheetGetCellFormulaSpreadsheetGetCellValue

SpreadsheetMergeCellsSpreadsheetSetCellCommentSpreadsheetSetCellFormula

履歴

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>

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー