SqlBulkCopy.ColumnMappings Свойство

Определение

Возвращает коллекцию элементов SqlBulkCopyColumnMapping.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

Значение свойства

SqlBulkCopyColumnMappingCollection

Коллекция сопоставлений столбцов.A collection of column mappings. По умолчанию является пустой коллекцией.By default, it is an empty collection.

Комментарии

Если источник данных и Целевая таблица имеют одинаковое число столбцов, а порядковый номер каждого исходного столбца в источнике данных совпадает с порядковым номером соответствующего целевого столбца, ColumnMappings коллекция не требуется.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. Однако если количество столбцов различается или порядковые номера не соответствуют друг другу, необходимо использовать, ColumnMappings чтобы убедиться, что данные скопированы в правильные столбцы.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. Любая попытка изменить ее вызовет исключение InvalidOperationException .Any attempt to change it will throw an InvalidOperationException.

Применяется к

См. также раздел