最終更新日 :
2021年4月28日
説明
初期化ファイルのプロファイルエントリの値を設定します。
戻り値
正常に実行された場合は空の文字列、そうでない場合はエラーメッセージ
履歴
ColdFusion 11：encoding 属性が追加されました。
カテゴリ
関数のシンタックス
SetProfileString(iniPath, section, entry, value, encoding) |
関連項目
GetProfileSections、GetProfileString
パラメータ
パラメータ |
説明 |
|---|---|
iniPath |
初期化ファイルの絶対パスです。 |
section |
初期化ファイルのセクションです。ここで指定したセクションの中にエントリが設定されます。 |
entry |
設定するエントリの名前です。 |
value |
エントリに設定する値です。 |
| encoding | 初期化（ini）ファイルのエンコーディング。例えば、「UTF-8」を指定します。 |
例
| <h3>SetProfileString Example</h3> This example uses SetProfileString to set the time-out value in an initialization file. Enter the full path of your initialization file, specify the time-out value, and submit the form. <!--- This section checks whether the form was submitted. If so, this section sets the initialization path and time-out value to the path and time-out value specified in the form ---> <cfif Isdefined("Form.Submit")> <cfset IniPath = FORM.iniPath> <cfset Section = "boot loader"> <cfset MyTimeout = FORM.MyTimeout> <cfset timeout = GetProfileString(IniPath, Section, "timeout")> <cfif timeout Is Not MyTimeout> <cfif MyTimeout Greater Than 0> <hr size = "2" color = "#0000A0"> <p>Setting the time-out value to <cfoutput>#MyTimeout#</cfoutput> </p> <cfset code = SetProfileString(IniPath, Section, "timeout", MyTimeout)> <p>Value returned from SetProfileString: <cfoutput>#code#</cfoutput></p> <cfelse> <hr size = "2" color = "red"> <p>The time-out value should be greater than zero in order to provide time for user response.</p> <hr size = "2" color = "red"> </cfif> <cfelse> <p>The time-out value in your initialization file is already <cfoutput>#MyTimeout#</cfoutput>.</p> </cfif> <cfset timeout = GetProfileString(IniPath, Section, "timeout")> <cfset default = GetProfileString(IniPath, Section, "default")> <h4>Boot Loader</h4> <p>The time-out is set to: <cfoutput>#timeout#</cfoutput>.</p> <p>Default directory is: <cfoutput>#default#</cfoutput>.</p> </cfif> <form action = "setprofilestring.cfm"> <hr size = "2" color = "#0000A0"> <table cellspacing = "2" cellpadding = "2" border = "0"> <tr> <td>Full Path of Init File</td> <td><input type = "Text" name = "IniPath" value = "C:¥myboot.ini"></td> </tr> <tr> <td>Time-out</td> <td><input type = "Text" name = "MyTimeout" value = "30"></td> </tr> <tr> <td><input type = "Submit" name = "Submit" value = "Submit"></td> <td></td> </tr> </table> </form> |
