XafApplication.CreateCustomLogonParameterStore Event
Occurs both when reading and writing the last logon parameters, before creating the logon parameters storage.
Namespace: DevExpress.ExpressApp
Assembly: DevExpress.ExpressApp.v24.1.dll
NuGet Package: DevExpress.ExpressApp
Declaration
Event Data
The CreateCustomLogonParameterStore event's data class is CreateCustomLogonParameterStoreEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Handled | Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. Inherited from HandledEventArgs. |
| Storage | Specifies a SettingStorage object which is used to load and save logon parameters. |
Remarks
A logon Window contains a View, which represents a Security System‘s logon parameters. By default, this View shows the last user’s parameters. To save and load these parameters, a special storage is created. The storage which is used in a Windows Forms application saves (or loads) parameters to the LogonParameters file. The storage which is used in an ASP.NET Web Forms application, saves (or loads) parameters to cookies. You can customize the default behavior by using another storage. For this purpose, handle the CreateCustomLogonParameterStore event. In the handler, create the required storage. The following storage types are available:
| Class | Storage |
|---|---|
| NullSettingsStorage | Logon parameters are not saved anywhere, and consequently, are not loaded from anywhere. |
| SettingsStorageOnHashtable | Hash table. |
| SettingsStorageOnRegistry | Registry. |
| SettingsStorageOnDictionary | LogonParameters file. Used in a Windows Forms application, by default. |
| SettingsStorageOnCookies | Cookies. Used in the ASP.NET Web Forms application, by default. |
Assign the storage you have created to the handler’s CreateCustomLogonParameterStoreEventArgs.Storage parameter.
To prohibit the creation of the default storage object, set the handler’s Handled parameter to true.