Locale Property

This property returns the locale (language) that the session was created with.

Syntax

Property Locale As CeLocale

Settings

LocVal may be any one of the values listed for CeLocale.

Remarks

The Crystal Enterprise SDK supports changing the locale. (This makes it possible for a client application to create multiple sessions, where each session has a different language). This is particularly important in installations where the web server could be providing services to customers internationally. In particular, this makes it possible for each web browser user to select his/her own locale while sharing the same web server. It is up to the web application developer to store user configuration for each user.

If you wish to use the constants listed in Settings above you must include one of the following files: CeConstJS.inc for JavaScript, or CeConstVBS.inc for VBScript. Both files are placed by default in C:\Program Files\Crystal Decisions\Web Content\Enterprise\websamples\.

Note:    Setting the locale is not enough to guarantee that the UI/errors will be displayed in the corresponding language. The language DLL (stringres_xx.dll) must be installed for the language. Also, the localization of HTML/CSP pages is up to the application developer. However, the CSP page can use the Locale property on the session to know whether to localize its output.