SETPROFILESTRING |
説明 初期化ファイルのプロファイルエントリの値を設定します。
戻り値 正常に実行された場合は空の文字列、そうでない場合はエラーメッセージ
カテゴリ システム関数
関数のシンタックス
    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>

INIPATH |
初期化ファイルの絶対パスです。

SECTION |
初期化ファイルのセクションです。ここで指定したセクションの中にエントリが設定されます。

ENTRY |
設定するエントリの名前です。

VALUE |
エントリに設定する値です。