SqlDataAdapter.UpdateBatchSize Propiedad
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í.
Obtiene o establece el número de filas procesadas en cada acción de ida y vuelta al servidor.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };
public override int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overrides Property UpdateBatchSize As Integer
Valor de propiedad
El 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 establecer este valor en un valor distinto de 1, todos los comandos asociados a SqlDataAdapter tienen que tener su propiedad UpdatedRowSource establecida None
en o OutputParameters
. De lo contrario, se produce una excepción.
Comentarios
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.
Utilice la UpdateBatchSize propiedad para actualizar un origen de datos con cambios de .DataSet Esto puede aumentar el rendimiento de la aplicación al reducir el número de recorridos de ida y vuelta al servidor.
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 produce un ArgumentOutOfRangeException valor si el valor se establece en un número menor que cero.