SqlBulkCopy.WriteToServer Method (DataTable)
Copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.
Assembly: System.Data (in System.Data.dll)
All rows in the DataTable are copied to the destination table except those that have been deleted.
While the bulk copy operation is in progress, the associated destination SqlConnection is busy serving it, and no other operations can be performed on the connection.
The ColumnMappings collection maps from the DataTable columns to the destination database table.
The following Console application demonstrates how to bulk load data from a DataTable. The destination table is a table in the AdventureWorks database.
In this example, a DataTable is created at run time and is the source of the SqlBulkCopy operation.
Important |
|---|
This sample will not run unless you have created the work tables as described in Bulk Copy Example Setup. This code is provided to demonstrate the syntax for using SqlBulkCopy only. If the source and destination tables are in the same SQL Server instance, it is easier and faster to use a Transact-SQL INSERT … SELECT statement to copy the data. |
Imports System.Data.SqlClient Module Module1 Sub Main() Dim connectionString As String = GetConnectionString() ' Open a connection to the AdventureWorks database. Using connection As SqlConnection = _ New SqlConnection(connectionString) connection.Open() ' Perform an initial count on the destination table. Dim commandRowCount As New SqlCommand( _ "SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _ connection) Dim countStart As Long = _ System.Convert.ToInt32(commandRowCount.ExecuteScalar()) Console.WriteLine("Starting row count = {0}", countStart) ' Create a table with some rows. Dim newProducts As DataTable = MakeTable() ' Note that the column positions in the source DataTable ' match the column positions in the destination table, ' so there is no need to map columns. Using bulkCopy As SqlBulkCopy = _ New SqlBulkCopy(connection) bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns" Try ' Write from the source to the destination. bulkCopy.WriteToServer(newProducts) Catch ex As Exception Console.WriteLine(ex.Message) End Try End Using ' Perform a final count on the destination table ' to see how many rows were added. Dim countEnd As Long = _ System.Convert.ToInt32(commandRowCount.ExecuteScalar()) Console.WriteLine("Ending row count = {0}", countEnd) Console.WriteLine("{0} rows were added.", countEnd - countStart) Console.WriteLine("Press Enter to finish.") Console.ReadLine() End Using End Sub Private Function MakeTable() As DataTable ' Create a new DataTable named NewProducts. Dim newProducts As DataTable = _ New DataTable("NewProducts") ' Add three column objects to the table. Dim productID As DataColumn = New DataColumn() productID.DataType = System.Type.GetType("System.Int32") productID.ColumnName = "ProductID" productID.AutoIncrement = True newProducts.Columns.Add(productID) Dim productName As DataColumn = New DataColumn() productName.DataType = System.Type.GetType("System.String") productName.ColumnName = "Name" newProducts.Columns.Add(productName) Dim productNumber As DataColumn = New DataColumn() productNumber.DataType = System.Type.GetType("System.String") productNumber.ColumnName = "ProductNumber" newProducts.Columns.Add(productNumber) ' Create an array for DataColumn objects. Dim keys(0) As DataColumn keys(0) = productID newProducts.PrimaryKey = keys ' Add some new rows to the collection. Dim row As DataRow row = newProducts.NewRow() row("Name") = "CC-101-WH" row("ProductNumber") = "Cyclocomputer - White" newProducts.Rows.Add(row) row = newProducts.NewRow() row("Name") = "CC-101-BK" row("ProductNumber") = "Cyclocomputer - Black" newProducts.Rows.Add(row) row = newProducts.NewRow() row("Name") = "CC-101-ST" row("ProductNumber") = "Cyclocomputer - Stainless" newProducts.Rows.Add(row) newProducts.AcceptChanges() ' Return the new DataTable. Return newProducts End Function Private Function GetConnectionString() As String ' To avoid storing the connection string in your code, ' you can retrieve it from a configuration file. Return "Data Source=(local);" & _ "Integrated Security=true;" & _ "Initial Catalog=AdventureWorks;" End Function End Module
Available since 2.0
