DbDataAdapter.UpdateBatchSize Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Data.Common
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs

Obtiene o establece un valor que habilita o deshabilita la compatibilidad con el procesamiento por lotes, y especifica el número de comandos que se pueden ejecutar en un lote.

public:
 virtual property int UpdateBatchSize { int get(); void set(int value); };
public virtual int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overridable Property UpdateBatchSize As Integer

Valor de propiedad

Int32

Número de filas que se van a procesar por lote.

Valor Efecto
0 No hay límite para el tamaño de lotes.
1 Deshabilita la actualización por lotes.
> 1 Los cambios se envían utilizando los lotes de las operaciones UpdateBatchSize a la vez.

Al establecerlo en un valor distinto de 1, todos los comandos asociados a DbDataAdapter deben tener su UpdatedRowSource propiedad establecida en None o OutputParameters. De lo contrario, se producirá una excepción.

Comentarios

Utilice la UpdateBatchSize propiedad para actualizar un origen de datos con cambios de .DataSet Si el proveedor de datos admite el procesamiento por lotes, esto puede aumentar el rendimiento de la aplicación reduciendo el número de recorridos de ida y vuelta al servidor. En ADO.NET 2.0, esta propiedad es compatible con los proveedores de datos .NET para SQL Server (SqlClient) y Oracle (OracleClient).

Si se ejecuta un lote demasiado grande, el rendimiento podría verse afectado. Por tanto, es conveniente realizar pruebas a fin de determinar el valor óptimo del tamaño del lote antes de implementar la aplicación.

Se producirá un ArgumentOutOfRangeException valor si el valor se establece en un número menor que cero.

Se aplica a

Consulte también