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

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

システム関数

SetProfileString(iniPath, section, entry, value)

GetProfileSections、GetProfileString、SetProfileString

<h3>SetProfileString の例</h3>
この例では、SetProfileString を使用して、初期化ファイルのタイムアウト値を設定します。初期化ファイルの絶
対パスを入力し、タイムアウト値を設定して、フォームを送信します。
<!--- このセクションでは、フォームが送信されたかどうかを確認します。送信された場合は、初期化パスおよびタ
イムアウト値を、フォームで指定されたパスとタイムアウト値に設定します。 --->
<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>タイムアウト値を <cfoutput>#MyTimeout#</cfoutput> に設定します。
      </p>
         <cfset code = SetProfileString(IniPath, 
            Section, "timeout", MyTimeout)>
      <p>SetProfileString の戻り値 : 
            <cfoutput>#code#</cfoutput></p>
      <cfelse>
         <hr size = "2" color = "red">
         <p>応答する時間をユーザーに与えるために、タイムアウト値には
            ゼロではなく正の数値を指定する必要があります。</p>
         <hr size = "2" color = "red">   
      </cfif>
   <cfelse>
      <p>初期化ファイル内のタイムアウト値は、既に
         <cfoutput>#MyTimeout#</cfoutput> に設定されています。</p>   
   </cfif>
   <cfset timeout = GetProfileString(IniPath, Section, "timeout")>
   <cfset default = GetProfileString(IniPath, Section, "default")>
   
   <h4>ブートローダー</h4>
   <p>タイムアウトの設定値 : <cfoutput>#timeout#</cfoutput></p>
   <p>デフォルトのディレクトリ : <cfoutput>#default#</cfoutput></p>
      
</cfif>

<form action = "setprofilestring.cfm">
<hr size = "2" color = "#0000A0">
<table cellspacing = "2" cellpadding = "2" border = "0">
<tr>
  <td>初期化ファイルの絶対パス</td>
  <td><input type = "Text" name = "IniPath" 
            value = "C:myboot.ini"></td>
</tr>
<tr>
  <td>タイムアウト</td>
  <td><input type = "Text" name = "MyTimeout" value = "30"></td>
</tr>
<tr>
  <td><input type = "Submit" name = "Submit" value = "送信"></td>
  <td></td>
</tr>
</table>
</form>