Edit

SqlBulkCopy.ColumnMappings Property

  • Reference

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Package:
System.Data.SqlClient v4.8.6

Returns a collection of SqlBulkCopyColumnMapping items. Column mappings define the relationships between columns in the data source and columns in the destination.

public:
 property System::Data::SqlClient::SqlBulkCopyColumnMappingCollection ^ ColumnMappings { System::Data::SqlClient::SqlBulkCopyColumnMappingCollection ^ get(); };
public System.Data.SqlClient.SqlBulkCopyColumnMappingCollection ColumnMappings { get; }
member this.ColumnMappings : System.Data.SqlClient.SqlBulkCopyColumnMappingCollection
Public ReadOnly Property ColumnMappings As SqlBulkCopyColumnMappingCollection

Property Value

SqlBulkCopyColumnMappingCollection

A collection of column mappings. By default, it is an empty collection.

Remarks

If the data source and the destination table have the same number of columns, and the ordinal position of each source column within the data source matches the ordinal position of the corresponding destination column, the ColumnMappings collection is unnecessary. However, if the column counts differ, or the ordinal positions are not consistent, you must use ColumnMappings to make sure that data is copied into the correct columns.

During the execution of a bulk copy operation, this collection can be accessed, but it cannot be changed. Any attempt to change it will throw an InvalidOperationException.

Applies to

See also