Programming ColdFusion

Name

CFREGISTRY

Synopsis

<CFREGISTRY>

Performs a registry operation, based on the value of the ACTION attribute.

Attributes

ACTION=" action "

The action for the CFREGISTRY tag to take. Required. Get retrieves a value from the registry and stores it in a variable. GetAll retrieves all the registry keys and values for a specified registry branch and stores them in a query object. Delete deletes a key or value from the registry. Set adds or updates a registry key or value.

BRANCH=" branch "

For Get, GetAll, and Set, the name of the registry branch containing the value to be accessed or set. For Delete, specifies either the name of the registry key to be deleted (don’t specify an ENTRY) or the name of the registry branch that contains the value to be deleted (specify a value for ENTRY). Required.

ENTRY=" key_or_value "

The value in the registry to be operated on. Required for all actions except GetAll and certain Delete operations.

TYPE=" type "

The type of registry data to be operated on. Valid entries are Key, DWord, and String (the default). Optional.

VARIABLE=" variable "

The name of a ColdFusion variable to hold the data returned by CFREGISTRY. Required for Get; ignored otherwise.

NAME=" query_name "

The name of a query object to hold the keys and values returned by CFREGISTRY. Required for GetAll; ignored otherwise.

SORT=" sort_criteria "

The sort order for the result set obtained by the CFREGISTRY action. Results may be ordered by Entry, Type, and Value. Multiple ...