ColdFusion 9.0 Resources |
cfregistryDescriptionThis tag is deprecated for the UNIX platform. Reads, writes, and deletes keys and values in the system registry. Provides persistent storage of client variables. Note: For this tag
to execute, it must be enabled in the ColdFusion Administrator.
For more information, see Configuring and Administering ColdFusion.
See alsocfcookie, cfparam, cfsavecontent, cfschedule, cfset; About resource and sandbox security and Using Persistent Data and Locking in the Developing ColdFusion Applications cfregistry action = "getAll"DescriptionReturns all registry keys and values defined in a branch. You can access the values as you would any record set. Syntax<cfregistry action = "getAll" branch = "branch" name = "query name" sort = "asc|desc" type = "string|dWord|key|any"> Note: You
can specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
Attributes
UsageThis tag returns #entry#, #type#, and #value# in a record set that you can access through tags such as cfoutput. To fully qualify these variables, use the record set name, as specified in the name attribute. If #type# is a key, #value# is an empty string. If you specify type= "any", getAll also returns binary registry values. For binary values, the #type# variable contains UNSUPPORTED and #value# is blank. Example<!--- This example uses cfregistry with the getAll action. ---> <cfregistry action = "getAll" branch = "HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM" type = "Any" name = "RegQuery"> <h1>cfregistry action = "getAll"</h1> <cftable query = "RegQuery" colHeaders HTMLTable border = "yes"> <cfcol header = "<b>Entry</b>" width = "35" text = "#RegQuery.Entry#"> <cfcol header = "<b>Type</b>" width = "10" text = "#RegQuery.type#"> <cfcol header = "<b>Value</b>" width = "35" text = "#RegQuery.Value#"> </cftable> cfregistry action = "get"Syntax<cfregistry action = "get" branch = "branch" entry = "key or value" variable = "variable" type = "string|dWord|key"> Note: You
can specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
Attributes
Example<!--- This example uses cfregistry with the get action. ---> <cfregistry action = "get" branch = "HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM" entry = "ClassPath" type = "String" variable = "RegValue"> <h1>cfregistry action = "get"</h1> <cfoutput> Java ClassPath value is #RegValue# </cfoutput> cfregistry action = "set"Syntax<cfregistry action = "set" branch = "branch" entry = "key or value" type = "string|dWord|key" value = "data"> Note: You can
specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
Attributes
Example<!--- This example uses the cfregistry set action to modify registry value data. ---> <!--- Normally you pass in a filename instead of setting one here. ---> <cfset FileName = "dummy.cfm"> <cfregistry action = "set" branch = "HKEY_LOCAL_MACHINE\Software\cflangref" entry = "LastCFM01" type = "String" value = "#FileName#"> <h1>cfregistry action = "set"</h1> cfregistry action = "delete"Syntax<cfregistry action = "delete" branch = "branch" entry = "key or value"> Note: You
can specify this tag's attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
Attributes
|