説明

初期化ファイルのプロファイルエントリの値を設定します。

戻り値

正常に実行された場合は空の文字列、そうでない場合はエラーメッセージ

履歴

ColdFusion 11:encoding 属性が追加されました。

カテゴリ

システム関数

関数のシンタックス

SetProfileString(iniPath, section, entry, value, encoding)

関連項目

GetProfileSectionsGetProfileString

パラメータ

パラメータ

説明

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>

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

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