DacDeployOptions Class

Defines options that affect the behavior of package deployment to a database.

Inheritance Hierarchy

System.Object
  Microsoft.SqlServer.Dac.DacDeployOptions

Namespace:  Microsoft.SqlServer.Dac
Assembly:  Microsoft.SqlServer.Dac (in Microsoft.SqlServer.Dac.dll)

Syntax

'Declaration
Public NotInheritable Class DacDeployOptions
'Usage
Dim instance As DacDeployOptions
public sealed class DacDeployOptions
public ref class DacDeployOptions sealed
[<SealedAttribute>]
type DacDeployOptions =  class end
public final class DacDeployOptions

The DacDeployOptions type exposes the following members.

Constructors

  Name Description
Public method DacDeployOptions Create a new instance of the DacDeployOptions class with default options.

Top

Properties

  Name Description
Public property AdditionalDeploymentContributorArguments Specifies additional deployment contributor arguments in addition to those already listed in the dacpac.
Public property AdditionalDeploymentContributors Specifies additional deployment contributors which should run - in addition to those specified in the dacpac.
Public property AllowDropBlockingAssemblies Get or set boolean that specifies whether CLR deployment will cause blocking assemblies to be dropped.
Public property AllowIncompatiblePlatform Get or set boolean that specifies whether deployment will block due to platform compatibility.
Public property BackupDatabaseBeforeChanges Get or set boolean that specifies whether a database backup will be performed before proceeding with the actual deployment actions.
Public property BlockOnPossibleDataLoss Get or set boolean that specifies whether deployment should stop if the operation could cause data loss.
Public property BlockWhenDriftDetected Get or set boolean that specifies whether the system will check for differences between the present state of the database and the registered state of the database and block deployment if changes are detected. Even if this option is set to true, drift detection will only occur on a database if it was previously deployed with the RegisterDataTierApplication option enabled.
Public property CommentOutSetVarDeclarations Get or set boolean that specifies whether the declaration of SQLCMD variables are commented out in the script header.
Public property CompareUsingTargetCollation Get or set boolean that specifies whether the source collation will be used for identifier comparison.
Public property CreateNewDatabase Get or set boolean that specifies whether the existing database will be dropped and a new database created before proceeding with the actual deployment actions. Acquires single-user mode before dropping the existing database.
Public property DeployDatabaseInSingleUserMode Get or set boolean that specifies whether the system will acquire single-user mode on the target database during the duration of the deployment operation.
Public property DisableAndReenableDdlTriggers Get or set boolean that specifies if all DDL triggers will be disabled for the duration of the deployment operation and then re-enabled after all changes are applied.
Public property DoNotAlterChangeDataCaptureObjects Get or set boolean that specifies whether items configured for Change Data Capture (CDC) should be altered during deployment.
Public property DoNotAlterReplicatedObjects Get or set boolean that specifies whether items configured for Replication should be altered during deployment.
Public property DropConstraintsNotInSource Get or set boolean that specifies whether to drop all constraints that do not exist in the source model.
Public property DropDmlTriggersNotInSource Get or set boolean that specifies whether to drop all DML triggers that do not exist in the source model.
Public property DropExtendedPropertiesNotInSource Get or set boolean that specifies whether to drop all extended properties that do not exist in the source model.
Public property DropIndexesNotInSource Get or set boolean that specifies whether to drop all indexes that do not exist in the source model.
Public property DropObjectsNotInSource Get or set boolean that specifies whether objects that exist in the target but not source should be dropped during deployment.
Public property DropPermissionsNotInSource Get or set boolean that specifies whether to drop all permissions that do not exist in the source model.
Public property DropRoleMembersNotInSource Get or set boolean that specifies whether to drop all role memberships that do not exist in the source model.
Public property GenerateSmartDefaults Get or set boolean that specifies whether default values should be generated to populate NULL columns that are constrained to NOT NULL values.
Public property IgnoreAnsiNulls Get or set boolean that specifies whether to exclude the ANSI_NULL option from consideration when comparing the source and target model.
Public property IgnoreAuthorizer Get or set boolean that specifies whether to exclude the AUTHORIZATION option from consideration when comparing the source and target model.
Public property IgnoreColumnCollation Get or set boolean that specifies whether to exclude the collation specifier from consideration when comparing the source and target model.
Public property IgnoreComments Get or set boolean that specifies whether to exclude comments from consideration when comparing the source and target model.
Public property IgnoreCryptographicProviderFilePath Get or set boolean that specifies whether to exclude the file specification of a cryptographic provider from consideration when comparing the source and target model.
Public property IgnoreDdlTriggerOrder Get or set boolean that specifies whether to exclude DDL trigger order from consideration when comparing the source and target model.
Public property IgnoreDdlTriggerState Get or set boolean that specifies whether to exclude DDL trigger state from consideration when comparing the source and target model.
Public property IgnoreDefaultSchema Get or set boolean that specifies whether to exclude the DEFAULT_SCHEMA option from consideration when comparing the source and target model.
Public property IgnoreDmlTriggerOrder Get or set boolean that specifies whether to exclude DML trigger order from consideration when comparing the source and target model.
Public property IgnoreDmlTriggerState Get or set boolean that specifies whether to exclude DML trigger state from consideration when comparing the source and target model.
Public property IgnoreExtendedProperties Get or set boolean that specifies whether to exclude all extended properties from consideration when comparing the source and target model.
Public property IgnoreFileAndLogFilePath Get or set boolean that specifies whether to exclude the FILENAME option of FILE objects from consideration when comparing the source and target model.
Public property IgnoreFilegroupPlacement Get or set boolean that specifies whether to exclude the filegroup specifier from consideration when comparing the source and target model.
Public property IgnoreFileSize Get or set boolean that specifies whether to exclude the SIZE option of FILE objects from consideration when comparing the source and target model.
Public property IgnoreFillFactor Get or set boolean that specifies whether to exclude the FILLFACTOR option from consideration when comparing the source and target model.
Public property IgnoreFullTextCatalogFilePath Get or set boolean that specifies whether to exclude the path specification of FULLTEXT CATALOG objects from consideration when comparing the source and target model.
Public property IgnoreIdentitySeed Get or set boolean that specifies whether to exclude the seed value of IDENTITY columns from consideration when comparing the source and target model.
Public property IgnoreIncrement Get or set boolean that specifies whether to exclude the increment value of IDENTITY columns from consideration when comparing the source and target model.
Public property IgnoreIndexOptions Get or set boolean that specifies whether to exclude differences in index options from consideration when comparing the source and target model.
Public property IgnoreIndexPadding Get or set boolean that specifies whether to exclude the PAD_INDEX option from consideration when comparing the source and target model.
Public property IgnoreKeywordCasing Get or set boolean that specifies whether to exclude difference in the casing of keywords from consideration when comparing the source and target model.
Public property IgnoreLockHintsOnIndexes Get or set boolean that specifies whether to exclude the ALLOW_ROW_LOCKS and ALLOW_PAGE_LOGKS options from consideration when comparing the source and target model.
Public property IgnoreLoginSids Get or set boolean that specifies whether to exclude the SID option of the LOGIN object from consideration when comparing the source and target model.
Public property IgnoreNotForReplication Get or set boolean that specifies whether to exclude the NOT FOR REPLICATION option from consideration when comparing the source and target model.
Public property IgnoreObjectPlacementOnPartitionScheme Get or set boolean that specifies whether to exclude the partition scheme object from consideration when comparing the source and target model for the following objects: Table, Index, Unique Key, Primary Key, and Queue.
Public property IgnorePartitionSchemes Get or set boolean that specifies whether to exclude the parameter type and boundary VALUES of a PARTITION FUNCTION from consideration when comparing the source and target model. Also excludes FILEGROUP and partition function of a PARTITION SCHEMA from consideration when comparing the source and target model.
Public property IgnorePermissions Get or set boolean that specifies whether to exclude all permission statements from consideration when comparing the source and target model.
Public property IgnoreQuotedIdentifiers Get or set boolean that specifies whether to exclude the QUOTED_IDENTIFIER option from consideration when comparing the source and target model.
Public property IgnoreRoleMembership Get or set boolean that specifies whether to exclude all ROLE MEMBERSHIP objects from consideration when comparing the source and target model.
Public property IgnoreRouteLifetime Get or set boolean that specifies whether to exclude the LIFETIME option of ROUTE objects from consideration when comparing the source and target model.
Public property IgnoreSemicolonBetweenStatements Get or set boolean that specifies whether to exclude the existence or absence of semi-colons from consideration when comparing the source and target model.
Public property IgnoreTableOptions Get or set boolean that specifies whether the options on the target table are updated to match the source table.
Public property IgnoreUserSettingsObjects Get or set boolean that specifies whether to exclude user settings from consideration when comparing the source and target model.
Public property IgnoreWhitespace Get or set boolean that specifies whether to exclude whitespace from consideration when comparing the source and target model.
Public property IgnoreWithNocheckOnCheckConstraints Get or set boolean that specifies whether to exclude the CHECK|NO CHECK option of a CHECK constraint object from consideration when comparing the source and target model.
Public property IgnoreWithNocheckOnForeignKeys Get or set boolean that specifies whether to exclude the CHECK|NO CHECK option of a FOREIGN KEY constraint object from consideration when comparing the source and target model.
Public property IncludeCompositeObjects Get or set boolean that specifies whether to include referenced, external elements that also compose the source model and then update the target database in a single deployment operation.
Public property IncludeTransactionalScripts Get or set boolean that specifies whether to use transations during the deployment operation and commit the transaction after all changes are successfully applied.
Public property NoAlterStatementsToChangeClrTypes Get or set boolean that specifies whether to force a change to CLR assemblies by dropping and recreating them.
Public property PopulateFilesOnFileGroups Get or set boolean that specifies whether files are supplied for filegroups defined in the deployment source.
Public property RegisterDataTierApplication Get or set boolean that specifies whether the database will be registered as a Data-Tier Application. If the target database is already a registered Data-Tier Application, then the registration will be updated.
Public property RunDeploymentPlanExecutors Specifies whether DeploymentPlanExecutor contributors should be run when other operations are executed. Default is false.
Public property ScriptDatabaseCollation Get or set boolean that specifies whether the target database should be altered to match the source model's collation.
Public property ScriptDatabaseCompatibility Get or set boolean that specifies whether the target database should be altered to match the source model's compatibility level.
Public property ScriptDatabaseOptions Get or set boolean that specifies whether the database options in the target database should be updated to match the source model.
Public property ScriptDeployStateChecks Get or set boolean that specifies whether the target database should be checked to ensure that it exists, is online and can be updated.
Public property ScriptFileSize Get or set boolean that specifies whether a file size is specified when adding files to file groups.
Public property ScriptNewConstraintValidation Get or set boolean that specifies whether constraints are validated after all changes are applied.
Public property ScriptRefreshModule Get or set boolean that specifies whether referencing procedures are refreshed when referenced objects are updated.
Public property SqlCommandVariableValues Get dictionary of SQL command variable values, keyed by variable name.
Public property TreatVerificationErrorsAsWarnings Get or set boolean that specifies whether the deployment operation should proceed when errors are generated during plan verification.
Public property UnmodifiableObjectWarnings Get or set boolean that specifies whether the deployment operation should proceed when errors are generated during plan verification.
Public property VerifyCollationCompatibility Get or set boolean that specifies whether deployment will verify that the collation specified in the source model is compatible with the collation specified in the target model.
Public property VerifyDeployment Get or set boolean that specifies whether the plan verification phase is executed or not.

Top

Methods

  Name Description
Public method Equals (Inherited from Object.)
Public method GetHashCode (Inherited from Object.)
Public method GetType (Inherited from Object.)
Public method ToString (Inherited from Object.)

Top

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.SqlServer.Dac Namespace