ServerBCPKeepIdentity Property

SQL-DMO

SQL-DMO

ServerBCPKeepIdentity Property

The ServerBCPKeepIdentity property controls the handling of existing values for a column with the identity property when importing data into the column.

Applies To
BulkCopy Object
Syntax

object.ServerBCPKeepIdentity [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetServerBCPKeepIdentity(LPBOOL pRetVal);

HRESULT SetServerBCPKeepIdentity(BOOL NewValue);

Remarks

When TRUE, SQL-DMO executes a SET IDENTITY_INSERT ON statement when the ImportData method of a Table object is called. Values for the identity column existing in the data file are copied to the referenced table's identity column.

When FALSE, SQL-DMO ignores any data values present for a column with the identity property. Microsoft® SQL Server™ 2000 generates data values for the column using the column's setting for identity seed and increment. The default is FALSE.

The ServerBCPKeepIdentity property is interpreted only when importing data and when the UseServerSideBCP property of the BulkCopy object is TRUE.