説明

初期化ファイルのエントリを取得します。初期化ファイルは、システムの起動時、オペレーティングシステムの起動時、またはアプリケーションの起動時に設定される、エントリとも呼ばれる環境変数に値を割り当てます。初期化ファイルには、boot.ini、Win32.ini のように、接尾辞 ini が付けられています。

戻り値

初期化ファイルのエントリの文字列。値がない場合は、空の文字列が返されます。

履歴

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

カテゴリ

システム関数

関数のシンタックス

GetProfileString(iniPath, section, entry, [encoding])

関連項目

GetProfileSectionsSetProfileString

パラメータ

パラメータ

説明

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>

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

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