Compartilhar via


SqlBulkCopy.ColumnMappings Propriedade

Definição

Retorna uma coleção de itens SqlBulkCopyColumnMapping. Mapeamentos de coluna definem as relações entre colunas na fonte de dados e colunas no destino.

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

Valor da propriedade

Uma coleção de mapeamentos de coluna. Por padrão, trata-se de uma coleção vazia.

Comentários

Se a fonte de dados e a tabela de destino tiverem o mesmo número de colunas e a posição ordinal de cada coluna de origem dentro da fonte de dados corresponder à posição ordinal da coluna de destino correspondente, a ColumnMappings coleção será desnecessária. No entanto, se as contagens de colunas forem diferentes ou se as posições ordinais não forem consistentes, você deverá usar ColumnMappings para garantir que os dados sejam copiados para as colunas corretas.

Durante a execução de uma operação de cópia em massa, essa coleção pode ser acessada, mas não pode ser alterada. Qualquer tentativa de alterá-lo lançará um InvalidOperationException.

Aplica-se a