最終更新日 :
2021年4月28日
説明
初期化ファイルのエントリを取得します。初期化ファイルは、システムの起動時、オペレーティングシステムの起動時、またはアプリケーションの起動時に設定される、エントリとも呼ばれる環境変数に値を割り当てます。初期化ファイルには、boot.ini、Win32.ini のように、接尾辞 ini が付けられています。
戻り値
初期化ファイルのエントリの文字列。値がない場合は、空の文字列が返されます。
履歴
ColdFusion 11：encoding 属性が追加されました。
カテゴリ
関数のシンタックス
GetProfileString(iniPath, section, entry, [encoding]) |
関連項目
GetProfileSections、SetProfileString
パラメータ
パラメータ |
説明 |
|---|---|
iniPath |
C:¥boot.ini のような初期化ファイルの絶対パスです (ドライブ、ディレクトリ、ファイル名、および拡張子)。 |
section |
情報の抽出する初期化ファイルのセクションです。 |
entry |
取得する値の名前です。 |
| encoding | 初期化（ini）ファイルのエンコーディング。例えば、「UTF-8」を指定します。エンコーディングのリストについては、「cffile action = "read"」を参照してください。 |
例
| <h3>GetProfileString Example</h3> Uses GetProfileString to get the value of timeout in an initialization file. Enter the full path of your initialization file, and submit the form. <!--- If the form was submitted, it gets the initialization path and timeout value specified in the form ---> <cfif Isdefined("Form.Submit")> <cfset IniPath = FORM.iniPath> <cfset Section = "boot loader"> <cfset timeout = GetProfileString(IniPath, Section, "timeout")> <h4>Boot Loader</h4> <!--- If no entry in an initialization file, nothing displays ---> <p>Timeout is set to: <cfoutput>#timeout#</cfoutput>.</p> </cfif> <form action = "getprofilestring.cfm"> <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><input type = "Submit" name = "Submit" value = "Submit"></td> <td></td> </tr></table> </form> |
