SqlBulkCopy Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase SqlBulkCopy.
Sobrecargas
| SqlBulkCopy(SqlConnection) |
Inicializa una instancia nueva de la clase SqlBulkCopy mediante la instancia abierta especificada de SqlConnection. |
| SqlBulkCopy(String) |
Inicializa y abre una instancia nueva de SqlConnection en función del valor |
| SqlBulkCopy(String, SqlBulkCopyOptions) |
Inicializa y abre una nueva instancia de SqlConnection basándose en el parámetro |
| SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction) |
Inicializa una nueva instancia de la clase SqlBulkCopy utilizando la instancia abierta proporcionada de SqlConnection. La instancia de SqlBulkCopy se comporta según las opciones proporcionadas en el parámetro |
SqlBulkCopy(SqlConnection)
Inicializa una instancia nueva de la clase SqlBulkCopy mediante la instancia abierta especificada de SqlConnection.
public:
SqlBulkCopy(System::Data::SqlClient::SqlConnection ^ connection);public SqlBulkCopy (System.Data.SqlClient.SqlConnection connection);new System.Data.SqlClient.SqlBulkCopy : System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlBulkCopyPublic Sub New (connection As SqlConnection)Parámetros
- connection
- SqlConnection
Instancia ya abierta de SqlConnection que se utilizará para realizar la copia masiva. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlCredential para pasar el Id. de usuario y la contraseña de forma más segura que especificando el identificador de usuario y la contraseña como texto en la cadena de conexión.
Ejemplos
La siguiente aplicación de consola muestra cómo cargar datos de forma masiva mediante una conexión que ya está abierta. En este ejemplo se usa SqlDataReader para copiar datos de la tabla Production.Product de la base de datos AdventureWorks de SQL Server en una tabla similar de la misma base de datos. Este ejemplo tiene como único fin realizar una demostración. No usaría SqlBulkCopy para mover datos de una tabla a otra en la misma base de datos de una aplicación de producción. Tenga en cuenta que los datos de origen no tienen que ubicarse en SQL Server; puede usar cualquier origen de datos que se pueda leer en o IDataReader cargar en .DataTable
Importante
Este ejemplo no se ejecuta a menos que haya creado las tablas de trabajo como se describe en Configuración de ejemplos de copia masiva. Este código se proporciona para mostrar la sintaxis para usar SqlBulkCopy. Si las tablas de origen y destino están en la misma instancia de SQL Server, es más fácil y rápido usar una instrucción Transact-SQL INSERT ... SELECT para copiar los datos.
using System.Data.SqlClient;
class Program
{
static void Main()
{
string connectionString = GetConnectionString();
// Open a sourceConnection to the AdventureWorks database.
using (SqlConnection sourceConnection =
new SqlConnection(connectionString))
{
sourceConnection.Open();
// Perform an initial count on the destination table.
SqlCommand commandRowCount = new SqlCommand(
"SELECT COUNT(*) FROM " +
"dbo.BulkCopyDemoMatchingColumns;",
sourceConnection);
long countStart = System.Convert.ToInt32(
commandRowCount.ExecuteScalar());
Console.WriteLine("Starting row count = {0}", countStart);
// Get data from the source table as a SqlDataReader.
SqlCommand commandSourceData = new SqlCommand(
"SELECT ProductID, Name, " +
"ProductNumber " +
"FROM Production.Product;", sourceConnection);
SqlDataReader reader =
commandSourceData.ExecuteReader();
// Open the destination connection. In the real world you would
// not use SqlBulkCopy to move data from one table to the other
// in the same database. This is for demonstration purposes only.
using (SqlConnection destinationConnection =
new SqlConnection(connectionString))
{
destinationConnection.Open();
// Set up the bulk copy object.
// Note that the column positions in the source
// data reader match the column positions in
// the destination table so there is no need to
// map columns.
using (SqlBulkCopy bulkCopy =
new SqlBulkCopy(destinationConnection))
{
bulkCopy.DestinationTableName =
"dbo.BulkCopyDemoMatchingColumns";
try
{
// Write from the source to the destination.
bulkCopy.WriteToServer(reader);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
finally
{
// Close the SqlDataReader. The SqlBulkCopy
// object is automatically closed at the end
// of the using block.
reader.Close();
}
}
// Perform a final count on the destination
// table to see how many rows were added.
long countEnd = 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();
}
}
}
private static string GetConnectionString()
// To avoid storing the sourceConnection string in your code,
// you can retrieve it from a configuration file.
{
return "Data Source=(local); " +
" Integrated Security=true;" +
"Initial Catalog=AdventureWorks;";
}
}
Imports System.Data.SqlClient
Module Module1
Sub Main()
Dim connectionString As String = GetConnectionString()
' Open a connection to the AdventureWorks database.
Using sourceConnection As SqlConnection = _
New SqlConnection(connectionString)
sourceConnection.Open()
' Perform an initial count on the destination table.
Dim commandRowCount As New SqlCommand( _
"SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
sourceConnection)
Dim countStart As Long = _
System.Convert.ToInt32(commandRowCount.ExecuteScalar())
Console.WriteLine("Starting row count = {0}", countStart)
' Get data from the source table as a SqlDataReader.
Dim commandSourceData As New SqlCommand( _
"SELECT ProductID, Name, ProductNumber " & _
"FROM Production.Product;", sourceConnection)
Dim reader As SqlDataReader = commandSourceData.ExecuteReader
' Open the destination connection. In the real world you would
' not use SqlBulkCopy to move data from one table to the other
' in the same database. This is for demonstration purposes only.
Using destinationConnection As SqlConnection = _
New SqlConnection(connectionString)
destinationConnection.Open()
' Set up the bulk copy object.
' The column positions in the source data reader
' match the column positions in the destination table,
' so there is no need to map columns.
Using bulkCopy As SqlBulkCopy = _
New SqlBulkCopy(destinationConnection)
bulkCopy.DestinationTableName = _
"dbo.BulkCopyDemoMatchingColumns"
Try
' Write from the source to the destination.
bulkCopy.WriteToServer(reader)
Catch ex As Exception
Console.WriteLine(ex.Message)
Finally
' Close the SqlDataReader. The SqlBulkCopy
' object is automatically closed at the end
' of the Using block.
reader.Close()
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 Using
End Sub
Private Function GetConnectionString() As String
' To avoid storing the sourceConnection 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
Comentarios
Dado que la conexión ya está abierta cuando se inicializa la SqlBulkCopy instancia, la conexión permanece abierta después de cerrar la SqlBulkCopy instancia.
Si el connection argumento es null, se produce una ArgumentNullException excepción .
Consulte también
Se aplica a
SqlBulkCopy(String)
Inicializa y abre una instancia nueva de SqlConnection en función del valor connectionString proporcionado. El constructor usa SqlConnection para inicializar una instancia nueva de la clase SqlBulkCopy.
public:
SqlBulkCopy(System::String ^ connectionString);public SqlBulkCopy (string connectionString);new System.Data.SqlClient.SqlBulkCopy : string -> System.Data.SqlClient.SqlBulkCopyPublic Sub New (connectionString As String)Parámetros
- connectionString
- String
Cadena que define la conexión que se abrirá para que la pueda usar la instancia de SqlBulkCopy. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlBulkCopy(SqlConnection) o SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction) y SqlCredential para pasar el Id. de usuario y la contraseña de forma más segura que especificando el identificador de usuario y la contraseña como texto en la cadena de conexión.
Ejemplos
En la siguiente aplicación de consola se muestra cómo cargar datos de forma masiva mediante una conexión especificada como una cadena. La conexión se cierra automáticamente cuando se cierra la SqlBulkCopy instancia.
En este ejemplo, los datos de origen se leen primero de una tabla de SQL Server a una SqlDataReader instancia de . Los datos de origen no tienen que encontrarse en SQL Server; puede usar cualquier origen de datos que se pueda leer en o IDataReader cargar en .DataTable
Importante
Este ejemplo no se ejecuta a menos que haya creado las tablas de trabajo como se describe en Configuración de ejemplos de copia masiva. Este código se proporciona para mostrar la sintaxis para usar SqlBulkCopy. Si las tablas de origen y destino están en la misma instancia de SQL Server, es más fácil y rápido usar una instrucción Transact-SQL INSERT ... SELECT para copiar los datos.
using System.Data.SqlClient;
class Program
{
static void Main()
{
string connectionString = GetConnectionString();
// Open a sourceConnection to the AdventureWorks database.
using (SqlConnection sourceConnection =
new SqlConnection(connectionString))
{
sourceConnection.Open();
// Perform an initial count on the destination table.
SqlCommand commandRowCount = new SqlCommand(
"SELECT COUNT(*) FROM " +
"dbo.BulkCopyDemoMatchingColumns;",
sourceConnection);
long countStart = System.Convert.ToInt32(
commandRowCount.ExecuteScalar());
Console.WriteLine("Starting row count = {0}", countStart);
// Get data from the source table as a SqlDataReader.
SqlCommand commandSourceData = new SqlCommand(
"SELECT ProductID, Name, " +
"ProductNumber " +
"FROM Production.Product;", sourceConnection);
SqlDataReader reader =
commandSourceData.ExecuteReader();
// Set up the bulk copy object using a connection string.
// In the real world you would not use SqlBulkCopy to move
// data from one table to the other in the same database.
using (SqlBulkCopy bulkCopy =
new SqlBulkCopy(connectionString))
{
bulkCopy.DestinationTableName =
"dbo.BulkCopyDemoMatchingColumns";
try
{
// Write from the source to the destination.
bulkCopy.WriteToServer(reader);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
finally
{
// Close the SqlDataReader. The SqlBulkCopy
// object is automatically closed at the end
// of the using block.
reader.Close();
}
}
// Perform a final count on the destination
// table to see how many rows were added.
long countEnd = 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();
}
}
private static string GetConnectionString()
// To avoid storing the sourceConnection string in your code,
// you can retrieve it from a configuration file.
{
return "Data Source=(local); " +
" Integrated Security=true;" +
"Initial Catalog=AdventureWorks;";
}
}
Imports System.Data.SqlClient
Module Module1
Sub Main()
Dim connectionString As String = GetConnectionString()
' Open a connection to the AdventureWorks database.
Using sourceConnection As SqlConnection = _
New SqlConnection(connectionString)
sourceConnection.Open()
' Perform an initial count on the destination table.
Dim commandRowCount As New SqlCommand( _
"SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
sourceConnection)
Dim countStart As Long = _
System.Convert.ToInt32(commandRowCount.ExecuteScalar())
Console.WriteLine("Starting row count = {0}", countStart)
' Get data from the source table as a SqlDataReader.
Dim commandSourceData As SqlCommand = New SqlCommand( _
"SELECT ProductID, Name, ProductNumber " & _
"FROM Production.Product;", sourceConnection)
Dim reader As SqlDataReader = commandSourceData.ExecuteReader
' Set up the bulk copy object using a connection string.
' In the real world you would not use SqlBulkCopy to move
' data from one table to the other in the same database.
Using bulkCopy As SqlBulkCopy = New SqlBulkCopy(connectionString)
bulkCopy.DestinationTableName = _
"dbo.BulkCopyDemoMatchingColumns"
Try
' Write from the source to the destination.
bulkCopy.WriteToServer(reader)
Catch ex As Exception
Console.WriteLine(ex.Message)
Finally
' Close the SqlDataReader. The SqlBulkCopy
' object is automatically closed at the end
' of the Using block.
reader.Close()
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 GetConnectionString() As String
' To avoid storing the sourceConnection 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
Comentarios
La conexión se cierra automáticamente al final de la operación de copia masiva.
Si connectionString es null, se produce una ArgumentNullException excepción . Si connectionString es una cadena vacía, se produce una ArgumentException excepción .
Consulte también
Se aplica a
SqlBulkCopy(String, SqlBulkCopyOptions)
Inicializa y abre una nueva instancia de SqlConnection basándose en el parámetro connectionString proporcionado. El constructor utiliza esa conexión SqlConnection para inicializar una nueva instancia de la clase SqlBulkCopy. La instancia de SqlConnection se comporta según las opciones proporcionadas en el parámetro copyOptions.
public:
SqlBulkCopy(System::String ^ connectionString, System::Data::SqlClient::SqlBulkCopyOptions copyOptions);public SqlBulkCopy (string connectionString, System.Data.SqlClient.SqlBulkCopyOptions copyOptions);new System.Data.SqlClient.SqlBulkCopy : string * System.Data.SqlClient.SqlBulkCopyOptions -> System.Data.SqlClient.SqlBulkCopyPublic Sub New (connectionString As String, copyOptions As SqlBulkCopyOptions)Parámetros
- connectionString
- String
Cadena que define la conexión que se abrirá para que la pueda usar la instancia de SqlBulkCopy. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlBulkCopy(SqlConnection) o SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction) y SqlCredential para pasar el Id. de usuario y la contraseña de forma más segura que especificando el identificador de usuario y la contraseña como texto en la cadena de conexión.
- copyOptions
- SqlBulkCopyOptions
Combinación de valores de la enumeración SqlBulkCopyOptions que determina las filas del origen de datos que se van a copiar a la tabla de destino.
Ejemplos
La siguiente aplicación de consola muestra cómo realizar una carga masiva mediante una conexión especificada como una cadena. Se establece una opción para usar el valor de la columna de identidad de la tabla de origen al cargar la tabla de destino. En este ejemplo, los datos de origen se leen primero de una tabla de SQL Server a una SqlDataReader instancia de . La tabla de origen y la tabla de destino incluyen una columna Identity. De forma predeterminada, se genera un nuevo valor para la columna Identidad en la tabla de destino para cada fila agregada. En este ejemplo, se establece una opción cuando se abre la conexión que obliga al proceso de carga masiva a usar los valores de identidad de la tabla de origen en su lugar. Para ver cómo cambia la opción de la forma en que funciona la carga masiva, ejecute el ejemplo con dbo. Tabla BulkCopyDemoMatchingColumns vacía. Todas las filas se cargan desde el origen. A continuación, vuelva a ejecutar el ejemplo sin vaciar la tabla. Se produce una excepción y el código escribe un mensaje en la consola que le notifica que no se agregaron filas debido a infracciones de restricciones de clave principal.
Importante
Este ejemplo no se ejecuta a menos que haya creado las tablas de trabajo como se describe en Configuración de ejemplos de copia masiva. Este código se proporciona para mostrar la sintaxis para usar SqlBulkCopy. Si las tablas de origen y destino están en la misma instancia de SQL Server, es más fácil y rápido usar una instrucción Transact-SQL INSERT ... SELECT para copiar los datos.
using System.Data.SqlClient;
class Program
{
static void Main()
{
string connectionString = GetConnectionString();
// Open a sourceConnection to the AdventureWorks database.
using (SqlConnection sourceConnection =
new SqlConnection(connectionString))
{
sourceConnection.Open();
// Perform an initial count on the destination table.
SqlCommand commandRowCount = new SqlCommand(
"SELECT COUNT(*) FROM " +
"dbo.BulkCopyDemoMatchingColumns;",
sourceConnection);
long countStart = System.Convert.ToInt32(
commandRowCount.ExecuteScalar());
Console.WriteLine("Starting row count = {0}", countStart);
// Get data from the source table as a SqlDataReader.
SqlCommand commandSourceData = new SqlCommand(
"SELECT ProductID, Name, " +
"ProductNumber " +
"FROM Production.Product;", sourceConnection);
SqlDataReader reader =
commandSourceData.ExecuteReader();
// Create the SqlBulkCopy object using a connection string
// and the KeepIdentity option.
// In the real world you would not use SqlBulkCopy to move
// data from one table to the other in the same database.
using (SqlBulkCopy bulkCopy =
new SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity))
{
bulkCopy.DestinationTableName =
"dbo.BulkCopyDemoMatchingColumns";
try
{
// Write from the source to the destination.
bulkCopy.WriteToServer(reader);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
finally
{
// Close the SqlDataReader. The SqlBulkCopy
// object is automatically closed at the end
// of the using block.
reader.Close();
}
}
// Perform a final count on the destination
// table to see how many rows were added.
long countEnd = 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();
}
}
private static string GetConnectionString()
// To avoid storing the sourceConnection string in your code,
// you can retrieve it from a configuration file.
{
return "Data Source=(local); " +
" Integrated Security=true;" +
"Initial Catalog=AdventureWorks;";
}
}
Imports System.Data.SqlClient
Module Module1
Sub Main()
Dim connectionString As String = GetConnectionString()
' Open a connection to the AdventureWorks database.
Using sourceConnection As SqlConnection = _
New SqlConnection(connectionString)
sourceConnection.Open()
' Perform an initial count on the destination table.
Dim commandRowCount As New SqlCommand( _
"SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
sourceConnection)
Dim countStart As Long = _
System.Convert.ToInt32(commandRowCount.ExecuteScalar())
Console.WriteLine("Starting row count = {0}", countStart)
' Get data from the source table as a SqlDataReader.
Dim commandSourceData As SqlCommand = New SqlCommand( _
"SELECT ProductID, Name, ProductNumber " & _
"FROM Production.Product;", sourceConnection)
Dim reader As SqlDataReader = commandSourceData.ExecuteReader
' Create the SqlBulkCopy object using a connection string
' and the KeepIdentity option.
' In the real world you would not use SqlBulkCopy to move
' data from one table to the other in the same database.
Using bulkCopy As SqlBulkCopy = _
New SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity)
bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns"
Try
' Write from the source to the destination.
bulkCopy.WriteToServer(reader)
Catch ex As Exception
Console.WriteLine(ex.Message)
Finally
' Close the SqlDataReader. The SqlBulkCopy
' object is automatically closed at the end
' of the Using block.
reader.Close()
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 GetConnectionString() As String
' To avoid storing the sourceConnection 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
Comentarios
Puede obtener información detallada sobre todas las opciones de copia masiva en el SqlBulkCopyOptions tema.
Consulte también
Se aplica a
SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction)
Inicializa una nueva instancia de la clase SqlBulkCopy utilizando la instancia abierta proporcionada de SqlConnection. La instancia de SqlBulkCopy se comporta según las opciones proporcionadas en el parámetro copyOptions. Si se suministra un valor no nulo SqlTransaction, las operaciones de copia se realizarán dentro de esa transacción.
public:
SqlBulkCopy(System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlBulkCopyOptions copyOptions, System::Data::SqlClient::SqlTransaction ^ externalTransaction);public SqlBulkCopy (System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlBulkCopyOptions copyOptions, System.Data.SqlClient.SqlTransaction externalTransaction);new System.Data.SqlClient.SqlBulkCopy : System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlBulkCopyOptions * System.Data.SqlClient.SqlTransaction -> System.Data.SqlClient.SqlBulkCopyPublic Sub New (connection As SqlConnection, copyOptions As SqlBulkCopyOptions, externalTransaction As SqlTransaction)Parámetros
- connection
- SqlConnection
Instancia ya abierta de SqlConnection que se utilizará para realizar la copia masiva. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlCredential para pasar el Id. de usuario y la contraseña de forma más segura que especificando el identificador de usuario y la contraseña como texto en la cadena de conexión.
- copyOptions
- SqlBulkCopyOptions
Combinación de valores de la enumeración SqlBulkCopyOptions que determina las filas del origen de datos que se van a copiar a la tabla de destino.
- externalTransaction
- SqlTransaction
Instancia existente de SqlTransaction en la que se va a realizar la copia masiva.
Comentarios
Si las opciones incluyen UseInternalTransaction y el externalTransaction argumento no es null, se produce una excepción InvalidArgumentException .
Para obtener ejemplos que muestran cómo usar SqlBulkCopy en una transacción, consulte Transacciones y operaciones de copia masiva.
Consulte también
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de