GET-PROPERTY( ) method

GET-PROPERTY( ) method

Gets the value of the specified application-defined property associated with the Client-principal object. The Client-principal object may be sealed or unsealed. If the specified property is not a valid property for the Client-principal object, or the property does not have a value, this method returns the Unknown value (?).

Return type: CHARACTER

Applies to: Client-principal object handle
Syntax
GET-PROPERTY( property-name ) 
property-name

A character string that specifies the name of an application-defined property associated with the Client-principal object. You must enclose this character string in quotes.

You can also use the LIST-PROPERTY-NAMES( ) method to retrieve a list of all application-defined properties associated with the Client-principal object.

The following code fragment illustrates how to use the GET-PROPERTY( ) method:
DEFINE VARIABLE hCP  AS HANDLE    NO-UNDO. 
DEFINE VARIABLE vVal AS CHARACTER NO-UNDO. 
. . . 
CREATE CLIENT-PRINCIPAL hCp. 
. . . 
vVal = hCP:GET-PROPERTY(“eye-color”). 
DISPLAY “Eye color: “ vVal. 
See also: LIST-PROPERTY-NAMES( ) method, SET-PROPERTY( ) method

Syntax
GET-PROPERTY( `property-name` )

DEFINE VARIABLE hCP AS HANDLE NO-UNDO. DEFINE VARIABLE vVal AS CHARACTER NO-UNDO. . . . CREATE CLIENT-PRINCIPAL hCp. . . . vVal = hCP:GET-PROPERTY(“eye-color”). DISPLAY “Eye color: “ vVal.

OpenEdge Release 10.2B