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.v20.2.dll

NuGet Packages: DevExpress.DataAccess, DevExpress.WindowsDesktop.DataAccess

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
Reporting	XRDesignMdiController	.SqlWizardSettings .DatabaseCredentialsSavingBehavior
Dashboard	DashboardDesigner	.DataSourceWizardSettings .DatabaseCredentialsSavingBehavior
	DashboardDesignerDataSourceWizardSettings	.SqlWizardSettings .DatabaseCredentialsSavingBehavior

Remarks

Enable the DataConnectionBase.StoreConnectionNameOnly property when you implement the IConnectionStorageService interface to serialize database connection names only. This behavior does not expose database credentials in report layout definitions.

When this property is disabled, the behavior depends on the SqlWizardSettings.DatabaseCredentialsSavingBehavior and IConnectionStorageService.CanSaveConnection property values.

SensitiveInfoSavingBehavior	Behavior
SensitiveInfoSavingBehavior.Prompt	IConnectionStorageService.CanSaveConnection is set to true After users select a connection or specify a new one, the Data Source Wizard displays the following page. IConnectionStorageService.CanSaveConnection is set to false After users select a connection or specify a new one, the Data Source Wizard displays the following page.
SensitiveInfoSavingBehavior.Always or SensitiveInfoSavingBehavior.Never	Users cannot specify whether or not to store database credentials with serialized layouts. After they select a connection or specify a new one, the Data Source Wizard displays the following page. IConnectionStorageService.CanSaveConnection is set to true IConnectionStorageService.CanSaveConnection is set to false The Wizard skips the page that allows users to specify how to save connections ving options is skipped and displays the next page.