SqlWizardSettings.DatabaseCredentialsSavingBehavior Property

Specifies whether or not to serialize database credentials along with document layouts (e.g., report or dashboards). Optionally, you can enable your end-users to select the required behavior.

Namespace: DevExpress.DataAccess.UI.Wizard

Assembly: DevExpress.DataAccess.v19.1.dll

Declaration

C#

[DefaultValue(SensitiveInfoSavingBehavior.Never)]
public SensitiveInfoSavingBehavior DatabaseCredentialsSavingBehavior { get; set; }

VB.NET

<DefaultValue(SensitiveInfoSavingBehavior.Never)>
Public Property DatabaseCredentialsSavingBehavior As SensitiveInfoSavingBehavior

Property Value

Type	Default	Description
SensitiveInfoSavingBehavior	**Never**	A SensitiveInfoSavingBehavior enumeration value.

Available values:

Name	Description
Always	Database credentials are always serialized along with document layouts and end-users cannot change this behavior.
Never	Database credentials are never serialized along with document layouts and end-users cannot change this behavior.
Prompt	After an existing connection is selected (or a new one is specified), the Data Source wizard prompts an end-user whether or not to save database credentials along with the document layout.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to DatabaseCredentialsSavingBehavior
Cross-Platform Class Library	DataSourceWizardSettings	.SqlWizardSettings.DatabaseCredentialsSavingBehavior
WinForms Controls	DataSourceWizardOptions	.SqlWizardSettings.DatabaseCredentialsSavingBehavior
Dashboard	DashboardDesigner	.DataSourceWizardSettings.DatabaseCredentialsSavingBehavior
	DashboardDesignerDataSourceWizardSettings	.SqlWizardSettings.DatabaseCredentialsSavingBehavior

Remarks

To always serialize only database connection names, set the DataConnectionBase.StoreConnectionNameOnly property to true. This will guarantee that the database credentials are never exposed in report layout definitions.

When this property is set to false (the default value), the resulting behavior depends on the settings defined for the SqlWizardSettings.DatabaseCredentialsSavingBehavior and IConnectionStorageService.CanSaveConnection properties.

SensitiveInfoSavingBehavior	Behavior
SensitiveInfoSavingBehavior.Prompt	IConnectionStorageService.CanSaveConnection is set to true After an existing connection is selected (or a new one is specified), the Data Source wizard displays the following page. IConnectionStorageService.CanSaveConnection is set to false After an existing connection is selected (or a new one is specified), the Data Source wizard displays the following page.
SensitiveInfoSavingBehavior.Always or SensitiveInfoSavingBehavior.Never	End-users cannot specify whether or not the database credentials will be stored along with serialized layouts, which depends on the specified DatabaseCredentialsSavingBehavior setting. After an existing connection is selected (or a new one is specified), the Data Source wizard displays the following page. IConnectionStorageService.CanSaveConnection is set to true IConnectionStorageService.CanSaveConnection is set to false The wizard page enabling end-users to specify connection saving options is skipped and the next wizard page is displayed.