SqlBulkCopy.BatchSize Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Número de filas en cada lote. Al final de cada lote, las filas del lote se envían al servidor.

public:
 property int BatchSize { int get(); void set(int value); };

public int BatchSize { get; set; }

member this.BatchSize : int with get, set

Public Property BatchSize As Integer

Valor de propiedad

Int32

Valor entero de la propiedad BatchSize o cero si no se ha establecido ningún valor.

Ejemplos

La siguiente aplicación de consola muestra cómo cargar datos de forma masiva en lotes de 50 filas. Para obtener un ejemplo que ilustra cómo BatchSize funciona con una transacción, consulte Operaciones de transacción y copia masiva.

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.

Comentarios

Un lote estará completo cuando se hayan procesado las filas indicadas por BatchSize o no haya más filas para enviar al origen de datos de destino.

Cero (valor predeterminado) indica que cada WriteToServer operación es un único lote.

Si la SqlBulkCopy instancia se ha declarado sin la UseInternalTransaction opción en vigor, las filas se envían a las filas del servidor BatchSize a la vez, pero no se realiza ninguna acción relacionada con la transacción. Si UseInternalTransaction está en vigor, cada lote de filas se inserta como una transacción independiente.

La BatchSize propiedad se puede establecer en cualquier momento. Si ya hay una copia masiva en curso, el tamaño del lote actual se ajusta según el tamaño del lote anterior. Los lotes posteriores usan el nuevo tamaño. Si inicialmente BatchSize es cero y cambia mientras una WriteToServer operación ya está en curso, esa operación carga los datos como un único lote. Las operaciones posteriores WriteToServer de la misma SqlBulkCopy instancia usan el nuevo BatchSize.