DbDataAdapter.UpdateBatchSize Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que permite ou desativa o suporte ao processamento por lote, e especifica o número de comandos que podem ser executados num batch.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public virtual int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overridable Property UpdateBatchSize As IntegerValor de Propriedade
O número de linhas a processar por lote.
| O valor é | Efeito |
|---|---|
| 0 | Não há limite para o tamanho do lote. |
| 1 | Desativa a atualização por lote. |
| > 1 | As alterações são enviadas usando lotes de UpdateBatchSize operações de cada vez. |
Ao definir este valor para um valor diferente de 1, todos os comandos associados DbDataAdapter devem ter a UpdatedRowSource sua propriedade definida como None ou OutputParameters. Caso contrário, será lançada uma exceção.
Observações
Use a UpdateBatchSize propriedade para atualizar uma fonte de dados com alterações a partir de um DataSetarquivo . Se o fornecedor de dados suportar processamento em lote, isto pode aumentar o desempenho da aplicação ao reduzir o número de idas e voltas ao servidor. No ADO.NET 2.0, esta propriedade é suportada para os fornecedores de dados .NET para SQL Server (SqlClient) e Oracle (OracleClient).
A execução de um lote extremamente grande pode diminuir o desempenho. Portanto, você deve testar a configuração de tamanho de lote ideal antes de implementar seu aplicativo.
An ArgumentOutOfRangeException será lançado se o valor for definido para um número inferior a zero.